There is a WHACK of info in that TOC. Your copyright is well-deserved =)
First off, I think we should have an ultra-quick install guide. If you're
like a lot of geeks, you know your stuff. You need to know a quick few
steps, a quick 2-3 gotchas, and BAM that's it. I want to make sure the
quick-and-dirty "impatient" install is available to the people who can take
advantage of it; admins experienced with other containers, trying Tomcat for
the first time perhaps.
PI.1.1: I agree with the "big picture" view of things, but from what's
there, it almost looks like you're explaining the parts that I as an admin,
would expect to see in the installation documentation. Was there something
more to this section than a description of Tomcat's internal layout?
PI.1.2: Agree with comments, remove to appendix. There are a million other
places on the Internet that introduce these things, and I'm sure they'll
have done a better job than most of us care to attempt.
PI.2.1: I love pictures! Some nice diagrams in here would go a lllong way.
Not sure about the "choose OS" or "install Java" sections. I mean, there's
catering to the LCD and there's catering to the LCD...
I think a lot of PI.2 is overkill, and some unnecessary, dependant upon the
implied length of the sections from the TOC I suppose... I mean one or two
sentences to "downloading JDK", sure, but more than that? Definitely more
suited to a book than "good enough" docs ;)
Overall, thanks for organizing this in such detail. It's a really good
read! I need to cook dinner and catch Law and Order. I'll reply to the
rest later =)
- r
