A very big +1, See feedback below..
> So please, can we at least START some discussion about the contents of the
> docs other than "we need to write them" ? There's a lot of work
> to be done,
> and I would imagine that someone knows where a good place is to start.
There are x main parts for the documentation :
- Why use tomcat, what does it do and what doesn't it do?
- Plain Installation and upgrades of the various tomcat versions (and maby
jserv upgrade to tomcat)
- Connectors and beyond ;-)) Why choose which connector and why don't use a
certain connector?
- Advanced configuration (what are all the entries for). In this case also
some references to technical docs which explain how to start writing eg
custom handlers, etc).
- Feature list as from tomcat 3 and as from tomcat 4 (group together
features and in which versions they appear/dissapear).
- a tomcat programmers manual
- a tips reference
- a faq reference (would be nice if there is a reference to the version it's
about or from what version the Question is valid.
- An administrator guide for tomcat.
Mvgr,
Martin van den Bemt