Re: The User Guide Needs You

[Stefan Kost <ensonic hora-obscura de>]

Hi Shaun,

> In the last few release cycles, our documentation has rotted.  It's been
> incredibly difficult to get new contributors hacking docs quickly, in
> part
> due to a high barrier to entry.
>
> In order to encourage collaborative editing, I've placed an outline for
> the User Guide on the wiki:
>
> http://live.gnome.org/DocumentationProject/UerGuide
>
> I encourage everybody to chip in what they can to complete the User
> Guide
> for Gnome 2.12.  Don't worry too much about formatting.  Do try to get
> lists and tables formatted somewhat correctly, otherwise the meaning
> might
> not be clear.  The wiki text will be converted by hand into DocBook, so
> it just needs to be understandable by a human.
>
> The purpose is to get the content right.  Don't just scribble down
> random
> notes.  Write good content.  If you want to insert a remark that
> shouldn't
> be in the actual document, put in a block in ALL-CAPS.
>
> If you have questions, ask.  Send an email to this list, or fire up your
> IRC client and join #docs on irc.gnome.org.
Is the old (2.10) user guide online somewhere? That would be a good base for all 
the chapters.

I noted that most chapters (except 'basic skills' and 'sessions') have an 
introduction. Would it be better to have the introduction on the parent node and 
spare the extra subchapter:

2 Desktop Overview
  <Introduction here>
2.1 Windows
...

Stefan