Re: More developer.gnome.org cleanup

[Shaun McCance <shaunm gnome org>]

On Wed, 2008-09-03 at 11:05 +0200, Murray Cumming wrote:
> On Tue, 2008-09-02 at 14:54 -0400, A. Walton wrote:
> > On Tue, Sep 2, 2008 at 9:48 AM, Shaun McCance <shaunm gnome org> wrote:
> > >> I think all 3 optimisation documents
> > >> http://developer.gnome.org/doc/guides/optimisation/
> > >> should be put in one DocBook document. Is there a suitable existing
> > >> DocBook document that we can just add a chapter to?
> > >> Here is the source HTML:
> > >> http://svn.gnome.org/viewvc/web-devel-2/trunk/content/doc/guides/optimisation/
> > >
> > > Already sort of done:
> > >
> > > http://svn.gnome.org/viewvc/gnome-devel-docs/trunk/optimization-guide/
> > >
> > > It's not included in the build yet, because somebody needs
> > > to clean it up and make sure it functions well as a single
> > > document.
> 
> If you add it to the build then we can put it on library.gnome.org and
> get more feedback.

Done.  I think it has to be explicitly added to library.

> > >> Are these Programming Guidelines worth saving? Here is the source HTML:
> > >> http://svn.gnome.org/viewvc/web-devel-2/trunk/content/doc/guides/programming-guidelines/
> > >
> > > It's a very old document.  I would want somebody to give it
> > > a hefty review and edit before we put it in gnome-devel-docs.
> > > All the same, it's a useful sort of document to have.
> 
> I'd rather do that editing _after_ it's become DocBook, rather than
> editing HTML. So can't we add it as Docbook to gnome-devel-docs svn at
> least?

Looking at the HTML, I see this:

<meta name="GENERATOR" content="Modular DocBook HTML Stylesheet Version 1.43" />

That says to me that, somewhere out there, there's some
DocBook for this document.  Can anybody find it?

(Looking at the HTML, I've a feeling it was generated by
the old DSSSL stylesheets.  That, combined with the age
of the document, make me think the document must be in
DocBook SGML.  But I'd still rather convert DocBook SGML
to DocBook XML than convert HTML to DocBook.)

--
Shaun