Re: Updating Handbook

[Daniel Carrera <dcarrera math toronto edu>]

Quick question:

Is "Yelp" the actual name of the documentation browser?  Is that what I
should call it?  What does it stand for?

Daniel.

On 29 Jan 2002, Alexander Kirillov wrote:

> 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
>
>
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
>