status of changing documents for gutsy
Duncan Lithgow
dlithgow at gmail.com
Thu Jun 14 06:56:02 UTC 2007
On Wed, 2007-06-13 at 21:44 -0400, Jonathan Jesse wrote:
> Now that Tribe1 has been out for a bit, has then been any updating going on
> the documents yet?
Thanks for raising this Jonathan.
I would like to join this question. I often have ideas and want to make
small contributions, but I can't really find out what the status of
anything is...
Several times I've seen good ideas dissolve into "we haven't decided
what direction the docs are taking..."
I was wondering if we could use the wiki better, maybe have a list of
shortterm/ midterm and longterm goals? Please put me right if I just
haven't found the relevant pages.
> Are we still moving forward with the topic based help structure?
Personally I don't think topic based works well, but that doesn't mean
much. What I think it does mean is that there should be a choice.
There's no special reason why both structures can't be available. It's
content navigation, not content in itself.
> What projects are we focusing on for Gutsy including Kubuntu?
Again I'll restate that I'm not the great workbeast here, and I'm
grateful to those who are. But in my opinion out focus needs to
be/include establishing a workflow for ensuring that the docs we release
are current. It's so disappointing to see doc pages which are out of
date and know that they are confusing new users, the opposite of what's
intended.
For both these points I think we need a wiki with a permissions system
we can use so that we can protect important documents from changes by
'outsiders'. I don't know if moin-moin can do this but I know other
wikis can. (I'm offline as I write, otherwise I'd lookup wikipedia's
comparison table for wiki systems.)
A special thanks to Matthew East for his consistent commitment to good
documentation.
Upward and onward for the Gutsy Gibbon.
Duncan
(the opinionated documentation fan without the skills or time to
contribute to the actual docs themselves... :-) )
More information about the ubuntu-doc
mailing list