tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Paulo Gaspar" <>
Subject RE: [VOTES] Tomcat 4.0-Beta-1 and New CVS Repositories
Date Fri, 05 Jan 2001 14:51:00 GMT
Tomcat has the same problem as Struts and most Open Source 
projects (it is not just an Apache thing):

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 []
> 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 ...

View raw message