Mailing-List: contact docs-help@httpd.apache.org; run by ezmlm
Precedence: bulk
Reply-To: docs@httpd.apache.org
Message-ID: <000d01c2b21f$34a00db0$0500000a@media>
From: "Kyle Hamilton" <williamhamilton@sbcglobal.net>
To: <docs@httpd.apache.org>
References: <200301020446.h024k8526490@Boron.MeepZor.Com>
Subject: Re: [STATUS] (httpd-docs-2.0) Wed Jan  1 23:46:08 EST 2003
Date: Wed, 1 Jan 2003 21:24:20 -0800
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit

Anyone want to make a Help Web site for apache users?
www.apachehelp.org

----- Original Message -----
From: "Rodent of Unusual Size" <Ken.Coar@Golux.Com>
To: "Apache httpd documenters" <apache-docs@Apache.Org>
Sent: Wednesday, January 01, 2003 8:46 PM
Subject: [STATUS] (httpd-docs-2.0) Wed Jan 1 23:46:08 EST 2003


> 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
>
> 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.
>
>               ------------------------------
>
> 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.
>     - add ids to non-directive sections of the module docs, so they
>       get a chance to be linked in the sidebar
>
> - Windows platform docs are in desperate need of rewrites/updates for 2.0.
>     - Bill Rowe and Bill Stoddard are good contacts for tech questions.
>     - "using apache" has been done, "compiling apache" is still open
>
> - New Auth system
>     - 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
>     - mod_status: updates for 2.0
>     - mod_example: updates for 2.0
>
> - 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
>      - 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
>         -D ONE_PROCESS
>               one-process-mode == no threads, i.e. only one
>               process handling the requests in a single loop?
>         -D NO_DETACH (not in every MPM avail.)
>               no daemon, but detached from terminal?
>         -D FOREGROUND (not in every MPM avail.)
>               ?
>
> - 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
>      - platform/ebcdic.xml - needs major rework for 2.0
>
> - New build process.
>     - install.html has had a first-pass rewrite, it is basically
>       accurate, but very incomplete.
>
> - API documentation
>     Status: Ben Laurie has written some hooks documentation
>
> - Several features in Apache require write-access to the filesystem.
>     Examples: CacheRoot, DavLockDB, ScriptLog
>     We should treat the things consistently in the docs, and perhaps
>     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
>
>
> Documentation improvements
> ==========================
>
> * New user docs: Directory Handling (mod_dir/mod_autoindex/etc)
>
> * Enhancements to the DTD/XSL:
>   - <glossary> tag that links to the glossary and uses some special
>     style in the css.
>   - New index: directives by context, including listing which directives
>     are available for each AllowOverride setting.
>   - New index: backout modules by type (aaa, mappers, loggers etc.)
>     probably by introducing a <category> element in modulesynopsis
>   - Use a tag like <var> in place of <em> for things like the
>     <syntax> listing.
>     - 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:
>       <page><variant lang="en" href="">title</variant>)?
>     - looking for other good ideas ;-)
>   - remove <pre> elements. Use <br /> and <indent> elements to get
>     same effect.
>   - need to add new <parentdocument> element to more docs
>
> * Autogeneration of PDF
>   - FOP?
>
> * Windows help file
>   - David Shane Holden was working on this
>
> * Improving the "security docs"
>   - More content and better organisation.
>     - mod_dav ressources are owned by the httpd
>
> * General cleaning and improving of module docs
>
> * 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
>
>   - This could be something a simple and hackish as a manual/extra/
>     directory (a la the 1.3 src/modules/extra/ directory) and a
>     script in the support directory that scans the files there and
>     updates the manual indices.  (We do something like that now for
>     httpd.conf file with apxs [LoadModule, etc.].)
>
> XML Conversions
> ===============
>
> The following files need to be converted to XML as described at
> http://httpd.apache.org/docs-project/docsformat.html
>
> index.html.en                      # leave in html?
> howto/auth.html.en
> misc/custom_errordocs.html         # obsolete?
> misc/descriptors.html              # obsolete?
> misc/fin_wait_2.html               # obsolete?
> misc/known_client_problems.html    # obsolete?
> misc/tutorials.html                # obsolete?
> expand.pl                          # delete after finishing everything
>
> # These will require manual.xsl changes
> faq/footer.html
> faq/header.html
> faq/index.html
> faq/support.html
>
> # Perhaps these should be left in html to allow the developers to
> # play with them
> developer/API.html
> developer/debugging.html
> developer/documenting.html
> developer/filters.html
> developer/footer.html
> developer/header.html
> developer/hooks.html
> developer/index.html
> developer/layeredio.html
> developer/request.html
> developer/thread_safety.html
> developer/modules.html.en
>
> # converting from nroff to xml
> programs/ab.html
> programs/apxs.html
> programs/dbmmanage.html
> programs/footer.html
> programs/header.html
> programs/htdigest.html
> programs/htpasswd.html
> programs/index.html
> programs/logresolve.html
> programs/other.html
> programs/rotatelogs.html
> programs/suexec.html
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
> For additional commands, e-mail: docs-help@httpd.apache.org
>


---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org