RE: Case Studies

At 11:13 AM 12/1/98 -0500, you wrote:
>In my experience the Apache docs are good once you get to know them, but

Very true.

>We're in a difficult situation right
>now because we're all (I assume) fairly comfortable with the docs
>and the other resources available (ApacheWeek, for example).
> All of this time we've
>spent with Apache has probably made us blind to the problems
>a novice will face just looking at the docs for the first time.

That's been the message I've been getting from people I've talked to.

>
>Maybe what we're talking about is a very general tutorial about Apache
starting to look at
>various web servers don't have to really struggle to get a grasp
>on what Apache is and does.

Once again, a very good point.

>
>As for the more in-depth documents (ie. mod_rewrite) those are the

This is where questions as to structure, presentation, audience etc. start to crop up. Once there's a good general in-English tutorial of the type you've described, a case could be made that the existing docs are sufficient for all other needs (e.g., sysadmins, programmers). So, should apache-docs concentrate solely on:

• producing a tutorial
• broadening/facilitating access to the existing docs (e.g., a document "portal" as has been suggested; creating numerous format versions such as PDF, SGML)

Do you need help?

In addition to our free technical library, Pantek provides professional IT services to companies who utilize Open Source software: Learn more about Pantek's Technical Support offerings Place an order for 24/7/365 Technical Support here Learn more about Pantek, who we are, and what we do Chat with a Live Operator Related httpd.apache.org Links announce bugs cvs dev docs gui-dev modproxy-dev packagers testers Request more information about Pantek

or do we need other levels/types of documentation? And if the latter, what?

Michele Received on Tue Dec 01 16:44:29 1998