UserDocumentation

Matthew East mdke at ubuntu.com
Sat Mar 25 14:47:28 UTC 2006


Duncan Lithgow <duncan <at> lithgow-schmidt.dk> writes:

> 
> I want to change the opening text a bit from
> 
> "The UserDocumentation page is the master index for documentation on the
> Ubuntu Wiki. Before editing this page, please read the WikiGuide page.
> Thanks!"
> 
> to
> 
> "The UserDocumentation page is the master index for documentation which
> has been reviewed and conforms to the guidelines in WikiGuide.

I don't think the user needs to have to try and figure out the process documents
go through before appearing in an index: I think that misses the point.

> If you
> can't find what you need here try the UserDocumentationRaw for
> unreviewed content. Before editing this page, please read the WikiGuide
> page. Thanks!"

What did you have in mind for UserDocumentationRaw? Documents which are still in
cleanup process? The whole point of not linking them on UserDocumentation is
because they are not ready for an index: having various indexes to allow
documents which aren't regarded as ready for the main index strikes me as (a)
difficult to maintain, and (b) defeating the object of trying to have guidelines
for documents in the first place.

At the moment, I have to say that the idea doesn't grab me at all: if we are
going to review the process that wiki documents go through before appearing in
the index, that is a positive idea, but we need to discuss what we want to get
out of the wiki and its document organisation and work out a proper solution, I
think.

Matt





More information about the ubuntu-doc mailing list