I see the docs in two parts, the man pages, which are a technical
reference, and the HOWTO stuff.  Seems to me like the technical ref
should be kept uptodate with the code, and the HOWTO stuff on the
wiki, where people can, hopefully, update it.

Even technical pages, having them quickly on the same server you are working under /docs or /_docs or /whatever with search could be easier, i like man pages but cross referencing and quick access is not their best

Pointing people in the right direction is a good idea though.  How
about a default start page for the installed server which focusses
more on what to do next, rather than advertising?  Could point to the
installed html version of the docs with a file:/// reference, and the
online wiki for HOWTO stuff, talk about the reference config file, and
the the stats module can be enabled for introspection stuff.

I do not see where to point now, too many pieces around, so i think about one repository for all docs, better under CVS so changes can be tracked and all docs easily retrievd by one cvs command.

The current index.adp in contrib doesn't mention any docs at all...
Or how t osign up to the mailing list, or how to report a bug, or how
to find modules to install...

Agree, why stats module is password protected, we can change it to make no password for locahost at least.

--
Vlad Seryakov
571 262-8608 office
[EMAIL PROTECTED]
http://www.crystalballinc.com/vlad/

Reply via email to