Updating Handbook

[Alexander Kirillov <kirillov math sunysb edu>]

Dear Daniel:
that would be great if you updated the Handbook. I actually thought
about doing that some time ago (when I had more free time) and I'll send
you whatever notes I have. Also, here is the list of changes:

1. We now use DocBook XML 4.1.2 

2. We only ship Doc Book XML files, no html - html will be generated
on-the-fly, using libxslt library and custom stylesheets
(gnome-docu/gdp/xsl)

3. We'll have new help browser, Yelp

4. GNOME 2 will have content-sensitive help (like extended tooltips -
a.k.a. "what's this". I don't know anything about this)

5. (This was already in GNOME 1.4, but not in the Handbook): Help
Browser will use scrollkeeper (scrollkeeper.sourceforge.net) to get the
list of all docs installed on your system, sorted by categories. Thus,
every doc must install an OMF file. 

6. We must refer to the style guide for all style questions (alos, it
includes a section on screenshot conventions)

Resources: 
Using DocBook 4.1.2: 
   http://www.math.sunysb.edu/~kirillov/dbxml (BTW, I updated it
recently)

Latest GDP Status report:
http://developer.gnome.org/projects/gdp/2001026gdpstatus.html

Porting guide for GNOME 2
  http://developer.gnome.org/dotplan/porting/

GDP Style Guide
  http://developer.gnome.org/documents/style-guide/

Templates:
  CVS:gnome-docu/gdp/templates/gnome-app-template.xml, legal.xml

Stylesheets:
  CVS:gnome-docu/gdp/xsl

Help API: need to ask Jonathan (jrb redhat com) - I believe he put this
somewhere in CVS, but I do not remember the location.


Hope this helps. Will try to catch you on IRC.

Sasha


On Mon, 2002-01-28 at 18:22, Daniel Carrera wrote:
> I am willing to update the Handbook.  But it looks like the problem is
> more serious than that.  We could meet at #doc to figure out what to do -
> and how I can help.  Is this a good idea?
> 
> If I am assigned the Handbook, I'd also appreciate someone giving me an
> idea of the changes necessary and I'll figure out the details.
> 
> I cam meet on Tuesdays, Thursdays, Saturdays and Sundays
> from:   10:00 (New York time) or 15:00 GTM
> to:     24:00 (New York time) or  5:00 GTM
> 
> Within those constraints, I'll work around people's schedules.
> 
> Regards,
> Daniel.
> 
> On Mon, 28 Jan 2002, John Fleck wrote:
> 
> > On Mon, Jan 28, 2002 at 02:45:16PM -0500, Alexander Kirillov wrote:
> > > According to CVS logs, Dan Mueth commented this out in Nov. 2000 - and
> > > the fact that it is still on the web shows that the web version was not
> > > updated since that time. jfleck: can you take care of this?
> > >
> >
> > This is a serious problem, and I have *no* idea how to fix it. Not only the
> > handbook, but several other files are not in sync on the web site with the
> > sgml/xml in cvs.
> >
> > This is a systems issue on the server, but I've no idea who set these build
> > systems up in the first place, how they were supposed to work, and why they
> > don't work now.
> >
> > Anyone?
> >
> > Cheers,
> >
> > John
> > _______________________________________________
> > gnome-doc-list mailing list
> > gnome-doc-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> >
> 
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list