GNOME 2 decisions (was Re: adopting the Style Guide)

[John Fleck <jfleck inkstain net>]

On Mon, Oct 15, 2001 at 08:58:43AM -0400, Alexander Kirillov wrote:
> Yes, it is about time we make oficial guidelines for 2.0 docs. Style
> guide should be the first of them. Additionally, it is about time we make
> decisions: 
>  - to switch to DocBook 4

I think Jonathan Blandford's help API suggests the answer to this -
DocBook 4.x XML is our GNOME 2 standard, with libxml2's DocBook
support providing backward compatibility for old SGML docs. I feel
like this is a decision that's been made. Am I wrong, folks?

>  - probably update templates 

Underway. I've already converted the gnome-app-template to xml
(gnome-app-template.xml is in cvs), though there's likely some
template tweaking still to be done because of discussions with Sun
about how to best meet their needs, and I've not gone through the
template with the Style Guide Fine Toothed Comb(tm).

>  - announce the official scheme for cross-referencing (ghelp?
>  gnome-hep? help?) 

Jonathan's API points to a solution to this. Jonathan?

>  - index and keywords: will Nautilus or whatever new help browser we
>  use be able to create document index from index tags? if so, should
>  we start using  them?
> 

Louise Miller at Sun is implementing this. I've cc'd her on this -
don't know if she's on the list, but perhaps she can explain in more
detail what she's up to and where she's at.

Cheers,
-- 
John Fleck
jfleck inkstain net (h), http://www.inkstain.net/fleck/
"Any man left on the Rio Grande is the King of the World as far as I know."
 - Becker and Fagen, 1973