Re: Improving GNOME docs...

[Shaun McCance <shaunm gnome org>]

On Sun, 2006-10-29 at 13:30 -0700, Brent Smith wrote:
> Dave Neary wrote:
> > ...and getting them into print
> > 
> > Hi all,
> > 
> > I have talked to Shaun about this idea already, and Andy Oram (on CC)
> > has been very generous with his ideas up to this point.
> > 
> > I have a dream. That when an engineer from a software developer goes to
> > developer.gnome.org that he will be in awe of the quality and
> > organisation of our developer documentation. That ISDs will choose our
> > platform because it's so damn easy to get started. That a GNOME guide
> > for ISDs will become a bestseller, and will generate some money for the
> > foundation. That through working with a professional editor, the GNOME
> > docs team gets bigger and better.
> > 
> > And then let's start all over again with user documentation.
> > 
> > I would like to ask the foundation to budget some money for editing work
> > to generate a great guide to the GNOME platform for ISDs. And I would
> > like to have the result of that work get into print, and end up on the
> > coffee-table of everyone on this list.
> > 
> > So - that's my crazy idea. Thoughts?
> > 
> 
> I started some work on a TableOfContents for developer documentation and
> then started working on it a bit.  Unfortunately, real life got in my
> way and now I don't have enough time to really pursue it.
> 
> http://www.gnome.org/~bmsmith/TableOfContents
> http://www.gnome.org/~bmsmith/gnome2-developer-guide.pdf
> 
> If there is interest in developing this more, I can import it into GNOME 
> CVS.  I have a typical gnome-doc-utils infrastructure set up for it already.

Rather than making yet another separate module,
let's put this into gnome-devel-docs.

--
Shaun