You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by Rodent of Unusual Size <Ke...@Golux.Com> on 2001/12/20 05:45:21 UTC

[STATUS] (httpd-docs-2.0) Wed Dec 19 23:45:21 EST 2001

Apache HTTP Server 2.0 Documentation Status File.
Last modified: $Date: 2001/12/07 19:54:00 $

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

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.

              ------------------------------

- IPv6: need to update some directives to show correct syntax for IPv6
    - Listen
    - NameVirtualHost/VirtualHost
    - Allow/Deny

- 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
    - 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.

- 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.
          - worker has no docs
          - the perchild directives in threaded/worker need docs

   - Individual docs will need some cleanup. 
        Status:  What docs still need to be touched here?
                 - invoking.html has had a first-pass cleaning done.
                 - 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 needs more
      work to be complete, and needs to track changes/bug-fixes
      in the build system.

- 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

- Translations
    We appear to have people working on translation into the following
    languages.  These may just be the 'it worked' page, but if so
    the authors of those should perhaps be contacted to help do the
    rest.. :-)  Note that this list is NOT identical to that for the
    1.3 documentation project..!

  [Should we attempt to get a known-current authorlist together? --jsl]

    - Catalan (.ca)
    - Czech Republic (.cz)
    - German (.de)
    - Danish (.dk)
    - Estonia (.ee)
    - Greek (.el)
    - Spanish (.es)
    - Estonian (.et)
    - French (.fr)
    - Hebrew (.he.iso8859-8)
    - Italian (.it)
    - Japanese (.ja.iso2022-jp, .ja.jis)
    - Korean (.kr.iso2022-kr, .kt.iso-kr)
    - ? (.ltz)
    - ? (.lu)
    - Dutch (.nl)
    - Norwegian (.no)
    - Polish (.po.iso-pl)
    - Portuguese (.pt)
    - Portuguese [Brasilian] (.pt-br)
    - Russian (.ru.cp-1251, .ru.cp866, .ru.iso-ru, .ru.koi8-r, .ru.ucs[248])
    - Swedish (.se)
    - Twi (.tw, .tw.big5)
      (is that supposed to be Chinese/Taiwanese?  Because if so, it is using
      the code reserved for Twi..)
    [Need this clarified --jsl]



New User documentation
======================

* Directory Handling (mod_dir/mod_autoindex/etc)

* Sections (<Directory>/<Files>/<Location>)


Documentation improvements
==========================

* Improving the "security docs"

  - More content and better organisation.

* 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.].)

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


RE: [STATUS] (httpd-docs-2.0) Wed Dec 19 23:45:21 EST 2001

Posted by Sylvain Boulesteix <sy...@ensta.org>.
> Welcome!

Thanks !


> There is nobody "in charge" in the traditional sense in apache.  There
> may be someone who knows more about the status of french translations,
> but I haven't seen much action recently.

... if somebody has already begun to translate one page, may be we are going to 
translate it twice ...?


> Your best bet is probably to just pick something to translate and post
> your results to the list.

OK !


> Joshua.

Sylvain.

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


RE: [STATUS] (httpd-docs-2.0) Wed Dec 19 23:45:21 EST 2001

Posted by Joshua Slive <jo...@slive.ca>.
> From: Sylvain Boulesteix [mailto:sylvain.boulesteix@ensta.org]

> I would like to help you to translate in FRENCH the apache
> documentation but I
> can't find the person who is actually in charge of this.

Welcome!

There is nobody "in charge" in the traditional sense in apache.  There may
be someone who knows more about the status of french translations, but I
haven't seen much action recently.  Your best bet is probably to just pick
something to translate and post your results to the list.

Joshua.


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


Re: [STATUS] (httpd-docs-2.0) Wed Dec 19 23:45:21 EST 2001

Posted by Sylvain Boulesteix <sy...@ensta.org>.
> 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 
> - Translations
>     We appear to have people working on translation into the following
>     languages.  These may just be the 'it worked' page, but if so
>     the authors of those should perhaps be contacted to help do the
>     rest.. :-)  Note that this list is NOT identical to that for the
>     1.3 documentation project..!
> 
>     - French (.fr)

I would like to help you to translate in FRENCH the apache documentation but I 
can't find the person who is actually in charge of this.


>   [Should we attempt to get a known-current authorlist together?
> --jsl]

Yes !


Sylvain Boulesteix.

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