You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Joshua Slive <sl...@finance.commerce.ubc.ca> on 2000/09/14 00:58:22 UTC

Template for modules docs

Here is a first draft of a template for the modules documents.  I would
greatly appreciate contributions of more detailed requirements and
feedback.

Changes from existing files:

- Always start with a one sentence description of the module, with no
excess cruft.

- Addition of "Status" and "Compatibility" headings near the top.
A corresponding change will need to be made to directive-dict.html

- Removal of any references to "compiled in by default", or the name of
the source file.  These are less meaningful in a dynamically loaded world,
and the name of the source file is obvious in any case.  It might be
useful to include a heading for the name used in the "LoadModule"
directive.  (config_log_module is not obvious for mod_log_config)

- A "Directives" section with links to all the directives is ALWAYS near
the top, immediately below "Summary"

- The directives themselves are always the LAST thing in the file.
(Some modules docs place examples or other stuff below the directives.
I think if the directives are linked near the top, then they should
be placed absolutely last.)

-- 
Joshua Slive
slive@finance.commerce.ubc.ca
http://finance.commerce.ubc.ca/~slive/
Phone: (604) 822-1871

Re: Template for modules docs

Posted by Joshua Slive <sl...@finance.commerce.ubc.ca>.
Second draft, with an included module-dict.html

The main changes, other than the inclusion of the module-dict,
is two new header fields near the top: source file name (obvious)
and module identifier (for use with LoadModule -- I couldn't come
up with a better name for it).  I also added an <HR> between
the header and the summary.

This obvious only works if people think it is worth following, so some
feedback would be good.

-- 
Joshua Slive
slive@finance.commerce.ubc.ca
http://finance.commerce.ubc.ca/~slive/
Phone: (604) 822-1871