You are viewing a plain text version of this content. The canonical link for it is here.
Posted to jetspeed-dev@portals.apache.org by Frans Thamura <ft...@yahoo.com> on 2001/06/29 11:18:28 UTC

[DOCUMENTATION] Fwd: Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS

Dear All,

I think JetSpeed team need much or more documentation.

You can read below email, which issued in tomcat
mailing list.

A lot of people confused with open source project
becuase less documentation, and less tips, and I
think, JetSpeed is one of them. I use JetSpeed in more
than 4 months, and I still got problem, thousand
question, and un-answered.

If you wish, would you give your time for this, this
will benefit all of you in next step of JetSpeed
development.

I can help you set up a methodology for JetSpeed
implementation, so new user or new commer in JetSpeed
can understand and learn JetSpeed in a couple days.

Frans






i could help with translations: french, german,
portuguese


----- Original Message ----- 
From: "GOMEZ Henri" <hg...@slib.fr>
To: <to...@jakarta.apache.org>
Cc: <to...@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).
> >




__________________________________________________
Do You Yahoo!?
Get personalized email addresses from Yahoo! Mail
http://personal.mail.yahoo.com/