Tomcat has the same problem as Struts and most Open Source
projects (it is not just an Apache thing):
* NOT ENOUGH DOCUMENTATION *
In the case of the Jakarta projects the APIs documentation is
usually quite satisfactory but the Introductions, HOW-TOs,
User Guides, Architecture and other overview-level
documentation are REAL CRAP!
Good and well organized introductory documentation (properly
marked by a big "Start Here" on the site) is the RIGHT WAY to
solve that kind of problems that new Tomcat users have.
Organizing code repositories in an unnatural way is the WRONG
WAY to do it:
- It is only going to simplify a very small part of the
problems those new users face;
- It is going to make developer's work harder.
I am sorry but I can not volunteer (at the moment) to help
solving the documentation problem. With the time limitations
I have, I must find a match with my employer interests in
order to contribute with some work. (If we start having more
developers using Tomcat, maybe then it makes some sense.)
At the time I am more focused on JSP, Struts and taglibs.
Which means that I will also not volunteer for that
mod_rewrite-like functionality that Jon asked for... but
maybe we will contribute some taglibs in the near future.
(Still must talk with the boss on that.)
Have fun,
Paulo Gaspar
> -----Original Message-----
> From: GOMEZ Henri [mailto:[EMAIL PROTECTED]]
> Sent: Friday, January 05, 2001 11:17
>
> >I don't see any problem - there are 2 codebases - the
> >"original" tomcat (
> >3.x ) and catalina ( 4.x ).
>
> You're in the project but imagine when a new user arrive and
> want to use a servlet engine ;-) The question will be must
> I use 3.2, 3.3, 4.0 or 4.1 ?-)
>
> A simple help rule could be :
>
> - If you have JDK 1.1 and Servlet 2.2/JSP 1.1, use 3.2/3.3
> - If you could use JDK 1.2 and need Servlet 2.3/JSP 1.1, use 4.0/4.1
>
> May be nice to add on tomcat site ...
>
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]
