Re: Improving GNOME docs...

[Dave Neary <dneary free fr>]

Hi,

Joachim Noreiko wrote:
>> We should start this in the wiki:
>> http://live.gnome.org/CodenameGraphite
> 
> You should look at and link to:
> 
> http://live.gnome.org/DeveloperGuides -- a list of the
> documents we should have that several people including
> Shaun worked on some time ago. 
> I think it's easier to work with a set of documents
> rather than a single great big monolith.

That's the intention. The idea is to link our existing documentation to
a nice skeleton for an ISD book/guide, and then work on making the
standard of docs both good and homogenous (the combination of the two
will be the hard bit). We're aiming squarely for the document that Shaun
calls the "Quick Guidebook for ISDs" - the other guides will, in my
mind, be chapters in the larger book project.

There looks to be some overlap between
http://live.gnome.org/DeveloperGuides,
http://live.gnome.org/IdealDeveloperDocumentation and
http://live.gnome.org/CodenameGraphite

We should consolidate these into at most 2 pages.

> It would be great if we got the docs team up and
> running, as we've been barely a handful for some time.
> Which reminds me, I must do some more work on the
> Handbook and Style guide so these ninja documentation
> writers know what to do.

Cool, thanks.

Cheers,
Dave.

-- 
David Neary
bolsh gnome org