From 3d8f65313e31a5d80b64ae43a663eeefbcefce33 Mon Sep 17 00:00:00 2001 From: Erik Abele Date: Sun, 1 Jun 2003 20:48:54 +0000 Subject: [PATCH] Added a note, a vote and a section about some necessary doco improvements. Removed a section about building the man pages from XML source. Also removed a section about possible cross references between the different languages. Both was fixed by Andre recently. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@100130 13f79535-47bb-0310-9956-ffa450edef68 --- docs/STATUS | 37 ++++++++++++++----------------------- 1 file changed, 14 insertions(+), 23 deletions(-) diff --git a/docs/STATUS b/docs/STATUS index 42753c8f25..fdfaa5b0e6 100644 --- a/docs/STATUS +++ b/docs/STATUS @@ -1,5 +1,5 @@ Apache HTTP Server 2.1 Documentation Status File. -Last modified: $Date: 2003/05/31 22:00:27 $ +Last modified: $Date: 2003/06/01 20:48:54 $ For more information on how to contribute to the Apache Documentation Project, please see http://httpd.apache.org/docs-project/ @@ -25,7 +25,7 @@ Decisions pending - Backport to 2.0 - +1: wrowe, slive, nd + +1: wrowe, slive, nd, erik - Figure out what to do about the 2.0 FAQ - Copy important stuff from 1.3? @@ -34,13 +34,17 @@ Decisions pending with the possibility to get nice commit mails.) nd: someone should try to convince me, what the heck is so cool with wikis - erik: it lowers the entry barrier and therefore users are able to - contribute (handy for a FAQ, see PHP site) + erik: it lowers the entry barrier and therefore users are able + to contribute without all the build hassles (see PHP site) nd: yes, good bad example. The PHP docs would mostly be better without these comments. I don't want to censor the entries, but also don't want to leave them without control. IMHO it's better to incorporate changes into the static docs. We need some better way of feedback, anyway. + erik: yes, the plan could be to have the wiki as some sort of + scratch_pad (clearly stated on the relevant pages) and + finally incorporate the useful info in it into the static + documentation Things That Need Fixing ======================= @@ -64,14 +68,6 @@ Things That Need Fixing - mod_rewrite: explain, when what variables are actually available (PR 16402) -- man pages - - Convert from nroff to our xml format. See list at bottom. - - Then if someone gets creative, they can try to find an automatic - way to convert back to nroff. - - An example: http://cyberelk.net/tim/data/xmlto/db2man/ - This is designed for docbook, but it could be adapted. - I'm not sure what the license is. - - MPM documentation - explain what the following command line options do (perhaps in the developer/debugging docs): @@ -127,23 +123,18 @@ Documentation improvements - in progress - add letter links to glossary and quickreference, perhaps also a term overview (sidebar) - - cross references between the different languages, - at least links from non-en docs to the originals. - - Javascript? - - post processing (s&r, XML::Parser, ...)? - - pre processing ([kind of] type maps - generated from sitemap entries like: - title)? - - looking for other good ideas ;-) - remove 
 elements. Use 
 and  elements to get
     a similar effect.
 
 * Autogeneration of PDF
-  - André is working on this, Erik volunteers to help out
+  - André is working on this, Erik volunteers to help out
+
+* Improving the documentation of the documentations' build system
+  itself (requirements, procedures)
 
 * Improving the "security docs"
-  - More content and better organisation.
-    - mod_dav ressources are owned by the httpd
+  - More content and better organisation
+  - mod_dav ressources are owned by the httpd
 
 * General cleaning and improving of module docs
 
-- 
2.40.0