summarizing docs-on-the-web discussion

[John Fleck <jfleck inkstain net>]

In an effort to summarize and focus the docs-on-the-web discussion,
let me try to step all over Jeff's toes and formalize this into a
proposal:

The Goals:

    To make documentation in GNOME cvs accessible on the web, in
    multiple forms.

    To make it easier for different classes of documentation to be
    created in DocBook in GNOME cvs and published on w.g.o in a
    variety of forms.

The forms:

    Chunked, displayed HTML
    downloadable PDF
    gzipped tarball of HTML (both chunked and single-page)
    Devhelp-compatible forms for the API docs (?)

The magic:

    Each doc will get its own directory on the web site. Quoting Jeff:
    "You tell a given directory that its content comes from a
    particular CVS server, module, branch/tag, which file is the root
    document etc. The docs are pulled in and built as if they were
    part of the tree already."

What we still need to do:

     Come up with a list for Jeff of all the cvs docs (with branches)
     so he and Steve can start waving their magic wands.

     Come up with a list of additional docs that are needed.

Does this about cover it?

Cheers,
John
-- 
John Fleck
jfleck inkstain net (h) jfleck abqjournal com (w)
http://www.inkstain.net http://www.abqjournal.com

"Sometimes, a diner is all about the mac and cheese." 
  - Zippy the Pinhead