Bug 634181

[Geert Janssens]

On Tuesday 27 January 2015 20:30:11 John Ralls wrote:
> > On Jan 27, 2015, at 7:02 PM, David T. <sunfish62 at yahoo.com> wrote:
> > 
> > John,
> > 
> > Thanks for your input.
> > 
> > As I look at this in greater detail, I see that this bug, combined
> > with my own recommendations in bug
> > https://bugzilla.gnome.org/show_bug.cgi?id=687820
> > <https://bugzilla.gnome.org/show_bug.cgi?id=687820> point toward a
> > bigger rewrite. Looking the two bugs over (along with the
> > interlinked bugs mentioned in the comments of the latter bug), my
> > preference would be to work up an extensive update to many chapters
> > of the Guide.
> > 
> > My question is this: assuming that I succeed in tackling the DocBook
> > Dilemma, at what level should I submit bugs and/or patches? At the
> > chapter level? At section levels? Should each patch go into a
> > separate bug, or should they all be entered under one of these two
> > bugs?
> Let's keep it simple and just use this bug. It will be easiest to
> apply if you make one patch per chapter since each chapter is a
> separate file. I don't remember if you need to renumber the chapters
> if you insert a new one; ISTR that DocBook takes care of that.
> Further discussion should take place on the bug rather than the
> mailing list.
> 
Docbook does indeed take care of the renumbering automatically.

Thanks for working on such much needed documentation updates, David !

Geert