httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From sl...@apache.org
Subject cvs commit: httpd-2.0/docs STATUS
Date Thu, 09 Jan 2003 20:15:04 GMT
slive       2003/01/09 12:15:04

  Modified:    docs     STATUS
  Log:
  Some status updates.  I removed a few things so as not to duplicate what
  we already have on the docs-project website.
  
  Revision  Changes    Path
  1.58      +22 -37    httpd-2.0/docs/STATUS
  
  Index: STATUS
  ===================================================================
  RCS file: /home/cvs/httpd-2.0/docs/STATUS,v
  retrieving revision 1.57
  retrieving revision 1.58
  diff -u -d -b -u -r1.57 -r1.58
  --- STATUS	16 Dec 2002 03:13:36 -0000	1.57
  +++ STATUS	9 Jan 2003 20:15:04 -0000	1.58
  @@ -1,26 +1,29 @@
   Apache HTTP Server 2.1 Documentation Status File.
   Last modified: $Date$
   
  -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.
  +Project, please see http://httpd.apache.org/docs-project/
   
                 ------------------------------
   
  -Things That Need Fixing
  -=======================
  +Decisions pending
  +=================
   
  -- Website
  -    - decide, whether to stick with httpd.apache.org/docs-x.y/
  -      scheme or choose another
  +- Where to put docs checkout on website
  +     - Leave it at /docs-x.y/
  +       +1: Joshua
         - /manual/x.y/
  -      - /x.y/manual/
  -      - ?
  +     - /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
  +=======================
   
   - XML
       - Rewriting of the remainder of the manual into xml is in
  @@ -36,13 +39,6 @@
       - 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 @@
           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 @@
   
   - 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 @@
       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
   ==========================
  @@ -148,9 +136,6 @@
   
   * 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
  
  
  

Mime
View raw message