[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). >
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
I think i can be Interested, because when you make documentation you get know product best. Tuukka ps. Tomcat really don't suX someone just do get i right:) Pioneering isn't easiest thing to do. --- --Me olemme keskella jotain. jossa olemme totaalisen ulkopuolisia-- On Fri, 29 Jun 2001 09:41:52 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). >> > Get 250 color business cards for FREE! http://businesscards.lycos.com/vp/fastpath/
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
i could help with translations: french, german, portuguese - Original Message - From: "GOMEZ Henri" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Cc: <[EMAIL PROTECTED]> 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). > >
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
Carlos Ferreira wrote: > > i could help with translations: french, german, portuguese And I with the Dutch version. I'd also be willing to write, but I'm quite new with Tomcat and since I started with JServ a year and a half ago, Tomcat isn't very transparant for me, I'm afraid...
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
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). > >
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
> So who will be interested in working on the Tomcat Documentation ? I am highly interested. I am writing a french tutorial about servlets (which can be found at http://darktigrou.free.fr/). It's a work in progress. I am also involved in the french python translation group (http://frpython.sourceforge.net/) and i love docs :-). So please let me know if this idea get into a real project. Regards, Julien Gilli.
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
I can offer Swedish translation from the english texts. Please take contact on [EMAIL PROTECTED] (private adress). Could be a nice way getting involved. Regards Roland Carlsson - Original Message - From: "Carlos Ferreira" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Friday, June 29, 2001 10:10 AM Subject: Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS > i could help with translations: french, german, portuguese > > > - Original Message - > From: "GOMEZ Henri" <[EMAIL PROTECTED]> > To: <[EMAIL PROTECTED]> > Cc: <[EMAIL PROTECTED]> > 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). > > > >
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
GOMEZ Henri wrote: > [...] > 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 ? > [...] Hi :-) if it is possible, I want to work for Tomcat Documentation :-) Bo June 29, 2001
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
I think a commiter must create a draft article, explain tomcat, and there will be a team, that will review, and ask that article, and may be several of those articles have a comment.. see php manual in php.net The team update the article, and after that. this like CVS for documentation, and the documentation is focus in English first, and follow with any other language. Frans - Original Message - From: "Tim Stoop" <[EMAIL PROTECTED]> To: <[EMAIL PROTECTED]> Sent: Friday, June 29, 2001 3:26 PM Subject: Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS > Carlos Ferreira wrote: > > > > i could help with translations: french, german, portuguese > > And I with the Dutch version. I'd also be willing to write, but I'm > quite new with Tomcat and since I started with JServ a year and a half > ago, Tomcat isn't very transparant for me, I'm afraid... _ Do You Yahoo!? Get your free @yahoo.com address at http://mail.yahoo.com
Re: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
On Fri, Jun 29, 2001 at 09:41:52AM +0200, GOMEZ Henri wrote: > So who will be interested in working on the Tomcat Documentation ? I'd be willing to proofread and validate any docs for the j-t-c (i.e. Apache/Tomcat integration). I don't have time to actually write the docs, but I could conceivably help those who don't understand how it works, but do have the time and patience to learn it and write docs for it. Anyone who is interested, just drop me a line. Writing end-user documentation is a good way of finding holes in a design that may not be obvious from the code itself. -- justin
RE: [Tomcat Documentation Redactors To Hire] - WAS: TOMCAT SUCKS
>I'd be willing to proofread and validate any docs for the j-t-c (i.e. >Apache/Tomcat integration). I don't have time to actually write the >docs, but I could conceivably help those who don't understand how it >works, but do have the time and patience to learn it and write docs >for it. Be our guest in j-t-c :) WebServer/Tomcat integration (Apache/TC, IIS/TC, mod_jk, webapp...) count at least 30% of questions on tomcat-user list :)
