Re: Shared Help System

[Shaun McCance <shaunm gnome org>]

On Tue, 2010-03-30 at 09:26 -0500, Shaun McCance wrote:
> Hi folks,
> 
> This is a rough write-up of what Rich and I discussed about
> a shared help system at the Desktop Help Summit about a week
> ago. I'm sending it first to the GNOME and KDE documentation
> lists. I'll send this out to more teams after we've all had
> a chance to comment.

Not a lot of response, so I'm going to assume everybody
on these two lists just trust us on this.

One comment from me:

> For DocBook documents, the directory is expected to contain
> either an index.docbook or a docname.xml file, where docname
> is the name of the documentation directory (help:docname).

We use index.page for Mallard and index.html for HTML, so why
don't we simplify this whole thing and always use index.docbook
for DocBook? We don't need to worry about compatibility with
GNOME's existing documents, because those are in a different
location and referenced with a different URI scheme.

--
Shaun