Re: GNOME Handbook of Writing Software Documentation rough draft

[Pat Costello <Patrick Costello Sun COM>]

> From what I can see Chapter 5 of the GDSG is almost the same as chapter 4 
> (DocBook Basics) in the GDH.  I'll use some of the introductory material, but 
> that is about it.  I like how the GDH gives an example of the DocBook 
> markup and then what the markup will look like.  It gives the new writers a 
> feel for what the finished DocBook will look like.
> 
> I do not believe that the GDH goes into the GDSG's territory.  Chapter 2 
> (Getting Started Writing GNOME Documentation) mainly gives an overview on how 
> to get started writing documentation and answers some of the most common 
> questions when starting to write documentation.  I've also tried to focus 
> Chapter 5 (GDP Document Conventions) on tag markup, the essential tags needed 
> in <articleinfo>, and copyright and licensing issues.
> 

Right...then it sounds like we can safely remove the DocBook Style section from 
the GDSG. Just making sure, that no-one is surprised if they miss the DocBook 
discussion in the style guide. We are planning a style update in the near 
future, so we will remove the DocBook Style section during that update. 

Pat