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 2002/07/04 05:45:33 UTC

[STATUS] (httpd-docs-1.3) Wed Jul 3 23:45:32 EDT 2002

Apache HTTP Server 1.3 Documentation Status File.
Last modified: $Date: 2002/06/09 11:34:54 $

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 sending an empty message 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.

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


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 2.0 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)
  - French (.fr)
  - Hebrew (.he.iso8859-8)
  - Italian (.it)
  - Japanese (.ja.jis)
  - Korean (.kt.iso-kr)
  - Luxembourgish (.lb)
  - 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)
  - Chinese (.zh)


Tutorials
=========

* Tutorial on "log files in apache"
  - Rich has kindy donated the "4-part logging article on Apache Today"
    articles that will need a little massaging.
  - Chris Pepper <pe...@reppep.com> has offered to look into this.

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

* Adding more documentation for new users

  - I believe that we'll need to get more info on what is missing, ie.
    user feedback and whatnot. --jsl


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-1.3) Wed Jul 3 23:45:32 EDT 2002

Posted by Rich Bowen <rb...@rcbowen.com>.
On Thu, 4 Jul 2002, Chris Pepper wrote:

> Rich,
>
> 	I was pretty much at a loss as to what was worth
> salvaging/rewriting from your articles in light of
> <http://httpd.apache.org/docs/logs.html>.
>
> 	If anyone has specifics of what they'd like to see, I'll take
> another stab at it; otherwise it should probably just come out of
> STATUS.

Yeah. I'm +1 on that. I will take a look at
http://httpd.apache.org/docs/logs.html and see if any improvements can
be made, and I'll take this note out of status.

Thanks, Chris.

>
>
> 						Chris
>
> At 8:38 AM -0400 2002/07/04, Rich Bowen wrote:
> >On Wed, 3 Jul 2002, Rodent of Unusual Size wrote:
> >
> >>  * Tutorial on "log files in apache"
> >>    - Rich has kindy donated the "4-part logging article on Apache Today"
> >>      articles that will need a little massaging.
> >>    - Chris Pepper <pe...@reppep.com> has offered to look into this.
> >
> >Chris, (or anyone)
> >
> >What is the status of this?
> >
> >It seems that http://httpd.apache.org/docs/logs.html really fills this
> >need, and we'd rather augment it than duplicate it. It also seems that
> >my goal of putting this sort of stuff in a howto/ subdirectory has
> >largely failed, and generated more duplication and confusion than
> >anything else.
> >
> >I'll poke at the logs document a bit, but I'm not sure that this needs
> >to stay in the STATUS doc any more. Comments?
>
>

-- 
Pilgrim, how you journey on the road you chose
To find out where the winds die and where the stories go
 --Pilgrim (Enya - A Day Without Rain)


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


Re: [STATUS] (httpd-docs-1.3) Wed Jul 3 23:45:32 EDT 2002

Posted by Chris Pepper <pe...@reppep.com>.
Rich,

	I was pretty much at a loss as to what was worth 
salvaging/rewriting from your articles in light of 
<http://httpd.apache.org/docs/logs.html>.

	If anyone has specifics of what they'd like to see, I'll take 
another stab at it; otherwise it should probably just come out of 
STATUS.


						Chris

At 8:38 AM -0400 2002/07/04, Rich Bowen wrote:
>On Wed, 3 Jul 2002, Rodent of Unusual Size wrote:
>
>>  * Tutorial on "log files in apache"
>>    - Rich has kindy donated the "4-part logging article on Apache Today"
>>      articles that will need a little massaging.
>>    - Chris Pepper <pe...@reppep.com> has offered to look into this.
>
>Chris, (or anyone)
>
>What is the status of this?
>
>It seems that http://httpd.apache.org/docs/logs.html really fills this
>need, and we'd rather augment it than duplicate it. It also seems that
>my goal of putting this sort of stuff in a howto/ subdirectory has
>largely failed, and generated more duplication and confusion than
>anything else.
>
>I'll poke at the logs document a bit, but I'm not sure that this needs
>to stay in the STATUS doc any more. Comments?

-- 
Chris Pepper:               <http://www.reppep.com/~pepper/>
Rockefeller University:        <http://www.rockefeller.edu/>

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


Re: [STATUS] (httpd-docs-1.3) Wed Jul 3 23:45:32 EDT 2002

Posted by Rich Bowen <rb...@rcbowen.com>.
On Thu, 11 Jul 2002, Joshua Slive wrote:

>
> On Thu, 4 Jul 2002, Rich Bowen wrote:
> > It also seems that
> > my goal of putting this sort of stuff in a howto/ subdirectory has
> > largely failed, and generated more duplication and confusion than
> > anything else.
>
> That's really my fault for not following your lead.  If you'd like to fix
> it by reorganizing what is there, please feel free.  I'm not really sure
> what the best thing to do is.

I think that moving the documents now might be considered a Bad Thing,
because of all of the links it would break (from other sites). I don't
think it's a bad deal. It was intended to reduce clutter, for the
*dozens* of howtos I had planned to write ;-)  Unfortunately, real life
got in the way.

-- 
Pilgrim, how you journey on the road you chose
To find out where the winds die and where the stories go
 --Pilgrim (Enya - A Day Without Rain)


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


Re: [STATUS] (httpd-docs-1.3) Wed Jul 3 23:45:32 EDT 2002

Posted by Joshua Slive <jo...@slive.ca>.
On Thu, 4 Jul 2002, Rich Bowen wrote:
> It also seems that
> my goal of putting this sort of stuff in a howto/ subdirectory has
> largely failed, and generated more duplication and confusion than
> anything else.

That's really my fault for not following your lead.  If you'd like to fix
it by reorganizing what is there, please feel free.  I'm not really sure
what the best thing to do is.

Joshua.


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


Re: [STATUS] (httpd-docs-1.3) Wed Jul 3 23:45:32 EDT 2002

Posted by Rich Bowen <rb...@rcbowen.com>.
On Wed, 3 Jul 2002, Rodent of Unusual Size wrote:

> * Tutorial on "log files in apache"
>   - Rich has kindy donated the "4-part logging article on Apache Today"
>     articles that will need a little massaging.
>   - Chris Pepper <pe...@reppep.com> has offered to look into this.

Chris, (or anyone)

What is the status of this?

It seems that http://httpd.apache.org/docs/logs.html really fills this
need, and we'd rather augment it than duplicate it. It also seems that
my goal of putting this sort of stuff in a howto/ subdirectory has
largely failed, and generated more duplication and confusion than
anything else.

I'll poke at the logs document a bit, but I'm not sure that this needs
to stay in the STATUS doc any more. Comments?

-- 
Rich Bowen
Apache - mod_perl - Perl - CGI
http://www.ApacheAdmin.com/


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