From 4cf04c1e660bc49f6a707852234171cecbf86ec3 Mon Sep 17 00:00:00 2001 From: Joshua Slive Date: Thu, 9 Jan 2003 20:15:04 +0000 Subject: [PATCH] Some status updates. I removed a few things so as not to duplicate what we already have on the docs-project website. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@98233 13f79535-47bb-0310-9956-ffa450edef68 --- docs/STATUS | 59 ++++++++++++++++++++--------------------------------- 1 file changed, 22 insertions(+), 37 deletions(-) diff --git a/docs/STATUS b/docs/STATUS index a30e3918f5..167b6e4de1 100644 --- a/docs/STATUS +++ b/docs/STATUS @@ -1,27 +1,30 @@ Apache HTTP Server 2.1 Documentation Status File. -Last modified: $Date: 2002/12/16 03:13:36 $ - -If you are interested in helping accomplish some of the tasks on this -list or otherwise improving the documentation, please join the -apache-docs mailing list by mailing to docs-subscribe@httpd.apache.org +Last modified: $Date: 2003/01/09 20:15:04 $ For more information on how to contribute to the Apache Documentation -Project, please see http://httpd.apache.org/docs-project/, and -http://apache-server.com/tutorials/ATdocs-project.html for an excellent -tutorial on how to get started with making your contribution. +Project, please see http://httpd.apache.org/docs-project/ ------------------------------ +Decisions pending +================= + +- Where to put docs checkout on website + - Leave it at /docs-x.y/ + +1: Joshua + - /manual/x.y/ + - /x.y/manual + +- Figure out what to do about the 2.0 FAQ + - Copy important stuff from 1.3? + - Some kind of XML? + - Something that allows dynamic contributions from users a la + FAQ-O-Matic? (I don't think any really good software exists + for this.) + Things That Need Fixing ======================= -- Website - - decide, whether to stick with httpd.apache.org/docs-x.y/ - scheme or choose another - - /manual/x.y/ - - /x.y/manual/ - - ? - - XML - Rewriting of the remainder of the manual into xml is in progress. See the bottom of this file for status info. @@ -36,13 +39,6 @@ Things That Need Fixing - Much clean-up and enhancement of aaa howto - Independent note on how to upgrade to new auth system -- Figure out what to do about the 2.0 FAQ - - Copy important stuff from 1.3? - - Some kind of XML? - - Something that allows dynamic contributions from users a la - FAQ-O-Matic? (I don't think any really good software exists - for this.) - - modules docs - mod_suexec: very little documentation - mod_proxy: updates for 2.0 @@ -58,10 +54,6 @@ Things That Need Fixing I'm not sure what the license is. - MPM documentation - - Non unix/windows MPMs still need to be completed. - - the perchild directives in threaded/worker need docs - - both in progress --nd - - explain what the following command line options do (perhaps in the developer/debugging docs): -D DEBUG @@ -86,7 +78,8 @@ Things That Need Fixing - New build process. - install.html has had a first-pass rewrite, it is basically - accurate, but very incomplete. + accurate, but very incomplete: many configure options are missing, + especially those inherited from apr. - API documentation Status: Ben Laurie has written some hooks documentation @@ -97,13 +90,8 @@ Things That Need Fixing suggest the use of directory like /usr/local/apache2/var/ that is httpd-writable. -- Translations - There are several efforts underway to translate the documentation - into other languages. A detailed list of the currently known - translators (and the corresponding websites) can be found at - - http://httpd.apache.org/docs-project/translations.html - +- SSL docs are generally good, but they need a refreshing by someone + familiar with mod_ssl and openssl. Documentation improvements ========================== @@ -149,9 +137,6 @@ Documentation improvements * Making the directive definitions "less terse" (i.e., adding more examples and details to the definitions of the directives) - - We'll need to audit these and find out which ones need munging, as - some of it looks ok. --jsl - * Making site-specific enhancements easier, including a documented and robust way for 3P module docco to be added -- and have it survive a server docco upgrade -- 2.40.0