Re: Making 2.26 Documentation Rock

[Shaun McCance <shaunm gnome org>]

On Sun, 2009-01-11 at 22:39 +0100, Milo Casagrande wrote:
> Hi,
> 
> Il giorno dom, 11/01/2009 alle 14.41 -0600, Shaun McCance ha scritto:
> > Do *NOT* set an initial status higher than "update".  Only
> > use "update" if the document seems to describe Gnome 2.24
> > reasonably well.  If the document is referring to a bunch
> > of stuff from 2.16 or something, or if it just never had
> > the information it should have, mark it as "incomplete"
> > or even "stub".
> > 
> > If you have experience with DocBook and have committed to
> > documentation in Gnome SVN before, you have my permission
> > to commit initial status information to any document that
> > is maintained by the GDP.  Otherwise, just send an email
> > to the list with a patch so we can make sure it's right.
> 
> following up on what you wrote, I've edited a little bit Empathy's doc
> adding the new status tracking. The updated document can be found in a
> bug report [1], please take a look at it.

Awesome.  You should also add a "planning" link in the
releaseinfo to the planning page on live.gnome.org.

Is there any reason you're not just working on this in
Gnome SVN directly?  I'm a big fan of Git, but having
your latest work in SVN means Pulse can track it, and
translators can start translating it.

--
Shaun

> > After that, get writing.  Try to move through the status
> > indicators.  Your first goal is to get a complete document
> > structure with technically correct information.  Stay in
> > touch with the mailing list, or ask question on the #docs
> > channel on irc.gnome.org.
> 
> I'll be back working on that document in the next days/weeks, updating
> the basic new features of Empathy and going a little bit further
> expanding it. Comments are more than welcome. 
> 
> Cheers.
> 
> [1] http://bugzilla.gnome.org/show_bug.cgi?id=561033