From: Joshua Slive Date: Sun, 15 Sep 2002 18:59:14 +0000 (+0000) Subject: Some status updates, including: X-Git-Tag: 2.0.42~21 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=41c6c46b68555af05090c84b8808f3562d8c053c;p=apache Some status updates, including: - a bunch of idea for improving the xml/xslt; feel free to add or subtract. - remove all the head.html/foot.html from the list of files to convert to xml. We may need to keep those around for a while to support translations. We'll look at it later. - general cleanup. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@96826 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/STATUS b/docs/STATUS index 562bd93836..7b06c77d1f 100644 --- a/docs/STATUS +++ b/docs/STATUS @@ -1,9 +1,9 @@ Apache HTTP Server 2.0 Documentation Status File. -Last modified: $Date: 2002/09/15 02:29:07 $ +Last modified: $Date: 2002/09/15 18:59:14 $ 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 apache-docs-subscribe@apache.org +apache-docs mailing list by mailing to docs-subscribe@httpd.apache.org For more information on how to contribute to the Apache Documentation Project, please see http://httpd.apache.org/docs-project/, and @@ -24,40 +24,30 @@ tutorial on how to get started with making your contribution. - mod_example: updates for 2.0 - man pages - - Some of the man pages need to be updated for 2.0. At least - the httpd man page appears to be outdated, and perhaps other. - After this is done, the manual/programs/ versions can be - regenerated using the program in the site-tools repository. + - Some of the man pages need to be updated for 2.0. + Presently, these are generated from nroff man pages using + the program in the site-tools repository, but nobody seems + willing to update the nroff files at the moment. + What should we do? - MPM documentation - - Each MPM needs to have a documentation file in manual/mod/ - which lists the directives it provides, and some details - about its operation. - Status: Initial outlines done. Much more details need to be - filled in. - - Non unix/windows MPMs still need to be completed. - - the perchild directives in threaded/worker need docs - - - Individual docs will need some cleanup. - Status: What docs still need to be touched here? - - misc/custom_errordocs.html needs to be updated to - essentially describe how the international error - docs included in 2.0 work - - misc/perf-tuning.html - needs major rewrite for 2.0 - - misc/tutorials.html - mostly not relevant to 2.0 - - misc/stopping.html - - misc/rewriteguide.html - needs cleaning in 1.3 and 2.0 - - misc/known_client_problems.html - mostly ancient + - Non unix/windows MPMs still need to be completed. + - the perchild directives in threaded/worker need docs + +- Individual docs will need some cleanup. + - misc/custom_errordocs.html needs to be updated to + essentially describe how the international error + docs included in 2.0 work + - misc/perf-tuning.html - needs major rewrite for 2.0 + - misc/tutorials.html - mostly not relevant to 2.0 + - misc/stopping.html + - misc/rewriteguide.html - needs cleaning in 1.3 and 2.0 + - misc/known_client_problems.html - mostly ancient - New build process. - install.html has had a first-pass rewrite, but many things have changed in the build system since it was written. -- Documentation of new features. - - This will probably require more input from new-httpd, since - not many people here follow the development process close - enough to know what is going on. - - API documentation Status: Ben Laurie has written some hooks documentation @@ -76,6 +66,22 @@ New User documentation Documentation improvements ========================== +* Enhancements to the DTD/XSL: + - tag that links to the glossary and uses some special + style in the css. + - ... tag to give some + more structure for the cookie-crumbs, etc. + - New index: directives by context, including listing which directives + are available for each AllowOverride setting. + - Add more information to the directives.html index (description, + syntax, context, ...) or perhaps add a quickreference.html + that contains this info. + - Use a tag like (but not that long) in place of + for things like the listing. + - Use the sitemap.xml in place of allmodules.xml to generate the + directives.html and mod/index.html. + - Handle more levels of sub
s. + * Improving the "security docs" - More content and better organisation. @@ -98,9 +104,6 @@ Documentation improvements updates the manual indices. (We do something like that now for httpd.conf file with apxs [LoadModule, etc.].) -* regex: We should at least document someplace what regex library we - are using and how to find more information about it - XML Conversions =============== @@ -108,34 +111,22 @@ The following files need to be converted to XML as described at http://httpd.apache.org/docs-project/docsformat.html ebcdic.html # Perhaps move to platform/ -footer.html # delete after finishing manual/ -header.html # delete after finishing manual/ index.html.en # leave in html? cgi_path.html.en howto/cgi.html.en howto/ssi.html.en howto/auth.html.en -howto/footer.html # delete after finishing howto/ -howto/header.html # delete after finishing howto/ misc/custom_errordocs.html # obsolete? misc/descriptors.html # obsolete? misc/fin_wait_2.html # obsolete? -misc/footer.html # delete after finishing misc/ -misc/header.html # delete after finishing misc/ misc/index.html misc/known_client_problems.html # obsolete? misc/perf-tuning.html misc/rewriteguide.html misc/tutorials.html # obsolete? -mod/footer.html # delete after finishing mod/ directory -mod/header.html # delete after finishing mod/ directory -platform/footer.html # delete after finishing platform/ -platform/header.html # delete after finishing platform/ platform/win_compiling.html platform/win_service.html platform/windows.html -ssl/footer.html # delete after finishing ssl/ -ssl/header.html # delete after finishing ssl/ ssl/index.html.en ssl/ssl_compat.html ssl/ssl_faq.html @@ -144,8 +135,6 @@ ssl/ssl_howto.html ssl/ssl_intro.html vhosts/details.html vhosts/examples.html -vhosts/footer.html # delete after finishing vhosts/ -vhosts/header.html # delete after finishing vhosts/ vhosts/ip-based.html vhosts/mass.html vhosts/index.html.en