tomcat-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Carlos Ferreira" <carlos.ferre...@gilem.com>
Subject Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
Date Fri, 29 Jun 2001 08:10:53 GMT
i could help with translations: french, german, portuguese


----- Original Message ----- 
From: "GOMEZ Henri" <hgomez@slib.fr>
To: <tomcat-user@jakarta.apache.org>
Cc: <tomcat-dev@jakarta.apache.org>
Sent: Friday, June 29, 2001 9:41 AM
Subject: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS 


> > Not to get into a great big argument over OS version commercial
> >products, but if OS projects expect to be taken with the same 
> >consideration
> >as commercial they have to accept to be compared across the board. This
> >includes documentation. You can't just pick and choose the 
> >battles you want
> >to fight. 
> 
> Could we close this thread positively ?
> 
> We all know that tomcat documentation is incomplete and we need help 
> in that area.
> 
> Tomcat IS AN OPENSOURCE project with a big user community,
> Jon Stevens recently reported more than 50-100k downloads / month.
> 
> Everybody could be involved in the project, and not necessary 
> developpers. I'm sure there is around potentials documentation 
> redactors.
> 
> So who will be interested in working on the Tomcat Documentation ?
> 
> ------------------------------------------------------------------
> 
> 
> >For the most part, the documentation in OS projects 
> >just plain
> >sucks, if it even exists. Believe it or not this is one of the 
> >reasons OS is
> >often frowned upon. Look at Microsoft, sure its close source, 
> >people may
> >think it sucks, blah blah blah, but do you have idea how much 
> >information is
> >on MSDN?
> > The lack of documentation available goes against some very basic
> >rules of Software Engineering. In the real world does this 
> >really matter? I
> >dunno, but often times packaging and presentation, and a 
> >finished looka nd
> >feel are the key to getting in the door and this is where most 
> >OS projects
> >fail miserably.
> > Because its free might be the reason the documentation sucks, it
> >shouldn't be a justification. (not that i'm saying tomcat sucks, just
> >argueing the point).
> >


Mime
View raw message