On Wed, 4 Jul 2001, Robert Slifka wrote:
> 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 ;)
>
That's why I called the current document "Application Developer's
Guide" instead, because it fit better in a User Documentation suite. :-)
Tomcat internals should be documented in the overall Developer
Documentation suite.
> 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.
>
Alas, it's not always that simple. If you did *anything* inside
server.xml for version X, you're going to have to know how to do the same
thing for version Y when you upgrade.
> > 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
>
Craig
