tomcat-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Alex Fernández <afm...@tid.es>
Subject Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
Date Fri, 29 Jun 2001 09:59:50 GMT
Hi Henri!

One suggestion: create a mailing list (e.g. tomcat-doc) so that folks
may speak about docs. Also, it would show some level of commitment -- at
least you have to subscribe.

Un saludo,

Alex.

GOMEZ Henri wrote:
> 
> >       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