Re: About GNOME / return / duck related question

[Shaun McCance <shaunm gnome org>]

On Thu, 2006-11-30 at 21:45 +0100, karderio wrote:
> A thought has been rattling around my head for a while. Many GNOME app
> manuals are in fact contained in the user guide. It's not quite clear
> which apps should have their own standalone manual, and which should be
> in the user guide. With Mallard, can we not have each app have it's own
> manual (thus simplifying calling the docs from the app, and letting the
> app be built independently of GNOME), and compose the user guide by
> including content from each app, and adding extra info if necessary.
> Something along these lines could be nice and modular, making things
> much more clear, whereas things currently seem a bit of a mess. Perhaps
> this is the plan already ?

Generally, I want the application help menu inside Yelp
to mirror the applications menu.  So that would mean all
applications get their own manual.  Things like Nautilus
or the panel should be in the User Guide.

With Mallard, node pages will be able to have links to
external documents mixed in with links to internal pages.
So from the standpoint of how we present the application
help menu, it will be irrelevant.

More importantly, help documents in Mallard are pluggable.
That means that, even if a module's help files are put in
the User Guide, they don't have to be maintained inside
gnome-user-docs.  Instead, they can be maintained inside
their respective modules, and they'll get installed into
the installed User Guide.

I hope that makes sense.  It works in my head.

--
Shaun