Re: GNOME Handbook of Writing Software Documentation rough draft

[Alexander Kirillov <kirillov math sunysb edu>]

On Tue, 2002-06-04 at 09:58, Pat Costello wrote:
> 
> > 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
No objections. 

Sasha