Documentation website

[Matthew East]

On Fri, 2007-02-02 at 22:38 +1300, Matthew Paul Thomas wrote:
> On Jan 28, 2007, at 5:15 AM, Matthew East wrote:
> > ...
> > I think the better solution here will be to focus on the system 
> > documents. I don't necessarily see the point of reproducing material 
> > on the website exactly as it appears on the user's system. The help 
> > website should supplement the system documentation, rather than 
> > reproducing it.
> 
> There are a couple of reasons to reproduce the built-in help on 
> help.ubuntu.com.

{snipped}

You're right. So how are we going to do it? Generating html and
attempting to fix the links either at build time or manually afterwards
is going to be pretty tricky. I think the best way is to pursue the
docbook -> wiki toolchain and fix the links manually. This would have
the benefit of integrating the material with the wiki, and getting rid
of the unhelpful help.ubuntu.com + help.ubuntu.com/community
distinction.

The disadvantage would be that we would probably have to stop
maintaining the localised help.ubuntu.com material (or rather, try and
provide a home for the English part of it within the wiki). To be
honest, I don't think that we can realistically maintain the localised
website anymore in any event; although we can help locoteams to use the
material on their own websites. 

Views/magic solutions welcome.
-- 
http://www.mdke.org
gnupg pub 1024D/0E6B06FF