AW = Antwort (this is German for RE:) or Antwoord (dutch for RE:)..
Agreed with your comments. Especially the unsubcribe part should me the
first sentence in the docs ;)
Especially digging into the extra libs will be very usefull. Need some
extensive docs on that. Especially tomcat 4 is confusing (although a lot
better now) with the huge number of libs it needs (or likes to have). Not
all libs are needed to build everything as far as I know, so it should also
state what functionality you're gonna miss (and maby some "real life"
examples of what that functionality can do for you). An example :
If you want to build in support for JNDI JDBC Datasource you to download
.... (snapped from the tomcat 4 README.txt). It is nice to know what you are
missing if you don't include this. Most admins don't have a clue what to do
with this and a lot of developers too. When you get a real life example
(just text, not necessarily code and a little more detailed then : you can
have JDBC datasources using JNDI when you use this). We don't want to be a
dictionary ;-))
A lot of people are confronted with stuff they would never have seen, so
some extra info could be usefull (I think I made my point).
Mvgr,
Martin
> -----Original Message-----
> From: Robert Slifka [mailto:[EMAIL PROTECTED]]
> Sent: Wednesday, July 04, 2001 3:46 PM
> To: '[EMAIL PROTECTED]'
> Subject: RE: PROPOSAL: Tomcat docs
>
>
> More refinements... if i didn't quote it, I agree with it =) BTW, what
> does "AW" in a subject line mean? I see it all the time...
>
> 0) Introduction to the TC4 container
> ADD > - Requirements (JDK versions, extra libs?, etc.)
>
> 1) "User's Guide" (or "Administrator's")
> > - Tomcat and different JDK Versions
> Moved this up to (0)
>
> > 2) "<web app development w/Tomcat>" Can't think of a title =)
> > ^
> > Tomcat Webdeveloper Guide
>
> I think we do need to separate out the fact that there are a
> group of people
> who will developing/embedding/extending Tomcat, and a group of people that
> will be developing web applications for Tomcat. As a web
> developer, I don't
> care a lot of about Tomcat's internals ;)
>
> 3) "Tomcat Upgrade Guide"
>
> I think this would equate to a lot of feature mapping from one
> container to
> another. The Admin's guide should suffice. REALLY all you need to do is
> drop a .WAR file in and change the port to get the container running
> standalone.
>
> > 4) "Appendix"
>
> Suggest that we move this all up into (0). I'd like people to know these
> things asap =) With the history of doc reading, I dunno anyone would make
> it this far!
>
> - r
>
