Re: Proposal

[Brian Behlendorf <br...@organic.com>]

On Thu, 27 Jun 1996 rasmus@madhaus.utcs.utoronto.ca wrote:
> http://www.apache.org/docs/modules.html does not list mod_info.  Here is
> the appropriate mod_info.html documentation file:

Okay, I've added it to the docs/1.1 directory, and the
docs/1.1/index.html, along with a pointer to an example on apache.org.  
The whole docs/ and docs/1.1 split I need to think about how that'll be
structured before going further....

	Brian

--=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=--
brian@organic.com  www.apache.org  hyperreal.com  http://www.organic.com/JOBS

Re: Proposal

[Alexei Kosut <ak...@nueva.pvt.k12.ca.us>]

On Sun, 30 Jun 1996, Brian Behlendorf wrote:

> On Thu, 27 Jun 1996 rasmus@madhaus.utcs.utoronto.ca wrote:
> > http://www.apache.org/docs/modules.html does not list mod_info.  Here is
> > the appropriate mod_info.html documentation file:
> 
> Okay, I've added it to the docs/1.1 directory, and the
> docs/1.1/index.html, along with a pointer to an example on apache.org.  
> The whole docs/ and docs/1.1 split I need to think about how that'll be
> structured before going further....

Well, the docs/1.1 thing was designed as a "here's what's new in the
beta" approach, so the "real" docs weren't messed up with 1.1 stuff,
and just to get everything documented in one place. (the Apache Group
seems to have somewhat of a problem documenting its work - witness the
CHANGES file, which we never agreed on how to handle, so it kind of
sits there until someone decides to update it, by poring through the
CVS logs. And a lot of the "documentation" on the web site still
applies to Apache 0.6 or 0.8. We really need someone to just go
through and rewrite the whole set).

IMO, what we should do is (I think I said this before) make a set of
1.1 docs, put that into /docs/, and take the existing files, and put
them into /docs/1.0/ or something, where they can still be accessed if
needed.

I mean, there are certainly worse ways of doing it. Taking two random
other freeware servers' docs, NCSA and CERN, it's very
interesting. NCSA's docs are basically useless as a reference medium,
because what you have is basically basic tutorials, and then release
notes. Wheras CERN's documentation is rather nice. It's crosslinked
about eight different ways, and it's all there in one place and
format. *shrug* Apache's are somewhere in the middle, I think.

-- 
________________________________________________________________________
Alexei Kosut <ak...@nueva.pvt.k12.ca.us>      The Apache HTTP Server
URL: http://www.nueva.pvt.k12.ca.us/~akosut/   http://www.apache.org/