323N/AApache HTTP Server Trunk Documentation Status File.
323N/AFor more information on how to contribute to the Apache Documentation
323N/A ------------------------------
323N/A- Rewriting the custom-error document, which is grossly outdated.
323N/A- Adding to the discussion of conditional logging, which I think
323N/A could be turned into more of a howto than the one paragraph it's
323N/A- Refer to this product as either 'Apache HTTP Server' or 'httpd', as
323N/A appropriate in context, rather than just 'Apache'. 'Apache' is the
1248N/A Apache Software Foundation.
323N/A- Remove mentions of the 1.2 and 1.3 versions of the server.
710N/A document to be useful. In particular:
752N/A - Document the various macros that can be used in documents.
752N/A - Document the translation process.
323N/A - Generally update it to make it reflect the current reality of how
643N/A - Improving the documentation of the documentations' build system
752N/A itself (requirements, procedures)
643N/A- Update this document. Determine which of these issues are in fact
643N/A still open, and which have already been dealt with.
710N/A- Identify which documents are grossly out of date, and fix.
710N/A- The FAQ never amounted to much. Review the current FAQ, which is
643N/A 1.3-era, and bring it into this century.
323N/A- Security docs are unhelpful, and assume that the reader knows nothing.
323N/A Need something a little more advanced, which either discusses
323N/A application-level security, or links to something that does. I'm not
323N/A even sure what to say needs done. Can we get someone to elaborate on
323N/A what, exactly, needs written? Ivan Ristic has said maybe he would be
1182N/A - More content and better organisation
1190N/A - mod_dav resources are owned by the httpd. Perhaps write up the
1182N/A two-httpd dav setup covered in Rich Bowen's DAV Apachecon
710N/A- Performance doc is way too low-level. Several people have said that
664N/A they might help out here, but it's a significant undertaking, and more
664N/A than a little daunting.
1190N/A - Bill Rowe and Bill Stoddard are good contacts for tech questions.
710N/A - "using apache" has been done, "compiling apache" is still open
710N/A - hints on uninstalling apache (exit monitor, close directories,
1182N/A registry entries etc) (PR 10154)
1182N/A - FAQ: UTF-8 config and URL encoding for non-ascii characters.
1182N/A - Much clean-up and enhancement of aaa howto
710N/A - Independent note on how to upgrade to new auth system
710N/A - Discussion of DBD auth, and, in particular, examples of how to set
323N/A up auth using each of the supported databases.
323N/A - the follwing modules added since 2.2 lack documentation
323N/A - mod_lbmethod_bybusyness
993N/A - mod_lbmethod_byrequests
323N/A - mod_lbmethod_bytraffic
323N/A - mod_lbmethod_heartbeat
643N/A the list may be incomplete
643N/A maybe some of the modules will not be included in 2.4
643N/A - mod_suexec: very little documentation
643N/A - mod_rewrite: explain, when which variables are actually available
643N/A - explain what the following command line options do
643N/A one-process-mode == no threads,
i.e. only one
643N/A process handling the requests in a single loop?
990N/A- Individual docs will need some cleanup.
710N/A -
dso.xml - Reads as though this is a nifty new thing we just came
710N/A - Ben Laurie has written some hooks documentation
710N/A - authn provider API documentation could be useful
1016N/A- SSL docs need serious update and enhancement
710N/A - compat docs are wrong
710N/A - no basic how to setup ssl doc
710N/A mads said he was working on this, but...
1182N/A- Missing documentation for the support program checkgid
959N/A (draft available in wiki)
990N/A - New index: directives by context, including listing which directives
999N/A are available for each AllowOverride setting.
999N/A - New index: backout modules by type (aaa, mappers, loggers etc.)
999N/A probably by introducing a <category> element in modulesynopsis
999N/A - Use a tag like <var> in place of <em> for things like the
999N/A - add letter links to glossary and quickreference,
999N/A perhaps also a term overview (sidebar)
999N/A - remove <pre> elements. Use <br /> and <indent> elements to get
1183N/A- Provide example solutions for the mapping of encodings, especially
999N/A for .gz etc. (also in regard to our default configuration)
999N/A- How-To style documents for more of the daily tasks
999N/A - Logging and log reporting
1183N/A- Writing modules - Can we provide a basic intro to writing modules,
999N/A perhaps based around mod_example, or one of the other simple example
991N/A profound embarrassment.
960N/A - Purge all the dead links
1190N/A - API docs are generated via 'make dox'. Find somewhere that we can
1183N/A do this on a schedule, and link to that from the documentation.
1190N/A - Introductory module authoring doc
1183N/A - Verify links to external resources at least every year
990N/A- Update the list of translations at
710N/A are accurate, and others are way outdated.
710N/A- Rewriting the 'custom error' doc, which is ancient and doesn't flow
710N/A- I'd like to expand the discussion of conditional logging, and add a
710N/A few more useful exmaples.
1183N/A- The mod_usertrack docs should describe what the module does, now,
752N/A rather than spending so much time comparing it to what a long-gone
752N/A module, which our readers never used, used to do. Examples would be
752N/A helpful. Additionally, a significant part of the doc consists of a
752N/A quoted email message. This seems somewhat unprofessional.
752N/A- Document mod_lua based on the various docs at
1182N/A- Dozens of other little problems with presentation, cross-referencing,
752N/A- Cleanup xsl to make it more readable. Almost everything
752N/A latex style files rarely have explict licenses. At worst, we can
752N/A drop this and manually adjust the relevant spacing.
752N/A- Reduce the size of the pdf (both bytes and pages) in any way possible.