Posted by Jerry Stuckle on 12/07/05 20:35

Nick Kew wrote:
> Jerry Stuckle wrote:
>
>> Nick Kew wrote:
>>
>>> Matt Probert wrote:
>>>
>>>> Explained? That's an interesting term to use with regard to the Apache
>>>> documentation! I find the Apache documentation to be slightly less
>>>> intelligible than if it were written in Ancient Greek.
>>>
>>>
>>>
>>>
>>> OK, here's a simple challenge. Find another complex product with
>>> documentation that's more readable than Apache's, while not being
>>> misleading or downright wrong.
>>>
>>
>> MySQL
>
>
> Hmmm, that's a very readable manual, too.
>
>> Microsoft's Visual Studio products
>
>
> You must be joking! Where do you find anything that isn't just a
> longwinded explanation of how to use GUI menus? It certainly
> never told me anything that wasn't bleedin' obvious.
>
> Unlike back in the 1980s, when a microsoft manual was somewhat
> helpful in learning C.
>
>> AutoCad
>
>
> never used it.
>
>> Websphere
>
>
> Put off even looking by the webpages and ambiguous license
> (not sure if that's changed since IBM started to get more
> serious about opensource).
>
>> Exim
>
>
> Well, I chose postfix in preference when I last changed MTA,
> and find postfix's documentation much harder than Apache's -
> though nevertheless adequately workable.
>
>>
>> To start.
>>
>> Apache's documentation is some of the worst I've ever seen.
>>
>
> How so? Instead of whinging, how about some constructive criticism
> that might offer some ideas for improving it?
>

Let's see...

More examples on how to do things. More information on how different
commands interrelate. How to effectively use .htaccess (or place those
commands in your httpd.conf file if you have access to it).

And how about some developer documentation? There isn't anything other
than an old Apache 1.x book mainly written for Perl with C as a second
thought.

If the documentation is so good, why are there so many messages on
usenet by people trying to figure out how to do things?

--
==================
Remove the "x" from my email address
Jerry Stuckle
JDS Computer Training Corp.
jstucklex@attglobal.net
==================

[Back to original message]