Bugzilla – Bug 1038
Add a new level of moule documentation.
Last modified: 2001-01-29 11:32:23 CET
Most of the module_doc constants are more used as more or less
brief description of the module. This is reflected in that the strings are
displayed in the verbose module listing modes of add module, which
typically is a bad place to show the entire documentation for a module, if
it is complicated enough.
I suggest somehing like a module_full_doc constant that keeps the complete
documentation of a module, so that it doesn't have to clutter the rest of
the interface. This information should be available though e.g. a
documentation tab a module level.
I think that that kind of documentation fits better in the manual, but it would
be easy to add a variable for it (not constant, though, since it should be
possible to localize it)
Well, it does fit better in the manual, but we want to be enable new modules to
have the same deep documentation as the one documented in the manual. We want
the raw documentation in the module file anyway...
If this module_full_doc is indeed meant to be imported into the manual (for at
least our own modules), generic HTML is by implication banned, and the admin
interface rendering of these docs should filter away all non-manual-markup tags
in order not to look like the docs are properly working when they are not. (The
same code that handles tagdoc ought to work fine.)
(If this is unwanted, [bug 1113] should be closed INVALID right away.)
You need to
before you can comment on or make changes to this bug.