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