Hi,
I just scanned the outline a bit. I will spend more time looking at
it.
However, after looking at for a very short time it I think I have the
following questions:
a. Are we talking about developing a manual for Apache that resembles
a
typical book format?
b. Are we interested in making the document easily searchable? Say
using
a search engine such as eXcite?
Personally, I think book-format will not be interesting since people
can just
go buy a book on Apache and its much prettier and easy to hold on your
hands.
I think the documentation project should consider:
i. Coverage of latest and greatest modules. I seldom find modules to
be well documented. [Exception: Ralf's modules! :) ]
ii. Introduction to the design of the Apache software. This is really
important as it is becoming more easy to tap into Apache via
mod_perl
and other modules which might allow access to Apache internals.
Well that's all I can think of for now.
Michele Petrovsky wrote:
>
> At 09:02 AM 11/3/98 -0800, you wrote:
> >Hi,
> >
> >I am interested in creating Apache end-user (i.e.
> >administrator) documentation as well.
> >I think it would be nice if there was a Web site which was
> >used to maintain and host
> >final version of the docs produced by this doc group. I can
> >provide a site for such a
> >project. But before that we need to establish some solid
> >goals. Shell we outline
> >some goals in this discussion group? I also think that there
> >should be different
> >levels of docs for beginning to advanced users of Apache.
> >
>
> Everything here makes a lot of sense.
>
> As something to get our thinking/discussion moving, I'm attaching
> a copy of an outline for an "Apache Users Guide". I'd forwarded
> this outline to new-httpd a few weeks ago, and some of the folks there
> felt it would be of use/a place to start with the kind of effort
> we've been discussing here today.
>
> Attachment is Word 6; if some other format is more convenient, please
> advise, and I'll resend.
>
> Michele
>
> ----------------------------------------------------------------------
> Name: PROP4ADC.DOC
> PROP4ADC.DOC Type: Microsoft Word Document (application/msword)
> Encoding: base64
--
Phone: (916) 649-9626
Fax: (916) 649-0209
Voice: (916) 649-9513
WWW: http://www.nitec.com
