Re: [STATUS] ADP (Thu 7-Aug-1997 23:27 MET DST)

In article <Pine.GSO.3.95q.970807221231.12443A-100000@csa> you wrote:

> On Thu, 7 Aug 1997, Ralf S. Engelschall wrote:

> >
> > STATUS of the Apache Documentation Project (ADP)

> I am a bit unclear of what, or more precisely who is the

Yes, correct. We need a Handbook for the developers and adcanced webmasters and a user manual for the avarage webmaster and normal user.

> There is a great need to separate the two, as writing the docs for

Exactly. Good point.

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

> Furthermore, I disagree on you plan to port all the existing docs to the

Yes, but I don't want to convert the existing docs manually. I want to write perl scripts who do 95% of the conversion and the ADP team also has to enhance it in the future for 1.3 and 2.0. Starting with not-changing topics is ok, too. We should do both. Writing from scratch is fine for not-changing topics and the remaining stuff is just automatically imported from the existing stuff.

> If immeddiate (i.e. 1.3) documentation is required, then i would recommend

No, it's not required, 1.3 is happy to be released with the current bunch of HTML pages. That's ok.

> Ralf: if it is possible for you to setup a table of contents on some web

I'll do this but first we should decide about the tools, because I hate doing things twice just because we want a different language/tool. So please first decide about the tool, then we discuss the TOC and then we discuss style guides and split the work. Is this order ok?

Greetings,

                                       Ralf S. Engelschall
                                       rse@engelschall.com
                                       www.engelschall.com