RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-10 Thread GOMEZ Henri
Craog I have a feeling that whatever is the same will be a lot of piecemeal here and there, excluding of course, web-app documentation. So far yourself, Pier, and Henri are the only three TC developers to post their position on that (re: inter-version relevancy). Pier and I also

RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-10 Thread Craig R. McClanahan
On Tue, 10 Jul 2001, GOMEZ Henri wrote: Craog I have a feeling that whatever is the same will be a lot of piecemeal here and there, excluding of course, web-app documentation. So far yourself, Pier, and Henri are the only three TC developers to post their position on that (re:

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-10 Thread Craig R. McClanahan
On Mon, 9 Jul 2001, Jon Stevens wrote: on 7/7/01 9:33 AM, Craig R. McClanahan [EMAIL PROTECTED] wrote: FWIW, I'm fine with Anakia, XSLT, Cocoon, Stylebook, Docbook, or whatever ... but IF AND ONLY IF the tags for use by the document authors are well documented, and the page generation

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-09 Thread Jon Stevens
on 7/7/01 9:33 AM, Craig R. McClanahan [EMAIL PROTECTED] wrote: FWIW, I'm fine with Anakia, XSLT, Cocoon, Stylebook, Docbook, or whatever ... but IF AND ONLY IF the tags for use by the document authors are well documented, and the page generation procedure is amenable to Ant scripting (not a

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-08 Thread Punky Tse
Developer in the sense of this sentence is a Tomcat developer. User is the people that just want to download, install, configure, and utilize Tomcat as a servlet container. Agree. That's why I suggested that we need to separate Developer Guide from User/Administrator Guide. I believed

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-07 Thread Craig R. McClanahan
On Sat, 7 Jul 2001 [EMAIL PROTECTED] wrote: On Fri, Jul 06, 2001 at 10:06:21PM -0700, Craig R. McClanahan wrote: * Docs should live in the source tree of the project that they are about. Although Henri's suggestion for jakarta-tomcat-docs is noble, what you'll find in practice

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-07 Thread Craig R. McClanahan
On Sat, 7 Jul 2001, Aaron Bannert wrote: On Sat, Jul 07, 2001 at 09:25:46AM -0700, Craig R. McClanahan wrote: Yes, we obviously need pointers in a top-level README on where the docs went. I'm willing to collaborate on these types of docs. On a slight tangent, I'd like to point out

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-06 Thread Craig R. McClanahan
On Mon, 2 Jul 2001, Jon Stevens wrote: on 7/2/01 5:58 PM, Pier P. Fumagalli [EMAIL PROTECTED] wrote: Excellent :) Anakia is a tool written by Jon to translate XML into HTML (correct me if I'm wrong) based on the same language that WebMacro uses... It generates

RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-06 Thread Craig R. McClanahan
On Mon, 2 Jul 2001, Rob S. wrote: This seems to be one of the questions that comes up and never gets answered (re: docs, not Jon's behavior ;) I'm not sure what magical solution will get people to read docs. Frankly, I'd just like to get started. Anakia works for Jakarta, Yep, thanks

RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-06 Thread Craig R. McClanahan
On Mon, 2 Jul 2001, Rob S. wrote: We've started writing some new docs in XML (catalina/docs/dev/xdocs). The HTML generation is done with XSL, but the DTD should be the same as the one used by Anakia. I noticed the xdocs directory, but I didn't see anything in there. I sent Craig

RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-03 Thread GOMEZ Henri
Probably even more... It allows more dummies to install our software, more dummies = more bugs found, more bugs found = more fixes, more fixes = better software... Or that's right only in f**ked up mind? :) Pier +1

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-03 Thread Justin Erenkrantz
On Mon, Jul 02, 2001 at 07:38:55PM -0700, Si Ly wrote: I submitted a very simple patch last week, and I haven't heard from anyone about it. It seems to me that outsiders (non-committers) can't get anything into CVS because the committers are not looking at the patches, for whatever reasons.

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-03 Thread cmanolache
On Mon, 2 Jul 2001, Si Ly wrote: I submitted a very simple patch last week, and I haven't heard from anyone about it. It seems to me that outsiders (non-committers) can't get anything into CVS because the committers are not looking at the patches, for whatever reasons. Sorry about that,

RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-03 Thread GOMEZ Henri
The patch is good, if nobody else get to submit it I'll do that when I return ( and start again on jasper - I just want to make sure the connector is in good state so we can finally have the beta ). If Costin agree with the patch, I'll commit them

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-03 Thread Jon Stevens
on 7/3/01 8:04 AM, Justin Erenkrantz [EMAIL PROTECTED] wrote: On Mon, Jul 02, 2001 at 07:38:55PM -0700, Si Ly wrote: I submitted a very simple patch last week, and I haven't heard from anyone about it. It seems to me that outsiders (non-committers) can't get anything into CVS because the

RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-03 Thread Larry Isaacs
:12 AM To: [EMAIL PROTECTED] Subject: Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire] On Mon, 2 Jul 2001, Si Ly wrote: I submitted a very simple patch last week, and I haven't heard from anyone about it. It seems to me that outsiders

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-03 Thread Christopher Cain
Geir Magnusson Jr. wrote: This is deja vu all over again. We should take one copy if this discussion (we had the same thing in Commons, and I am sure it happened everywhere else...), post it somewhere, and people can just submit article numbers or something rather than typing the same

Re: AW: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-03 Thread cmanolache
On Tue, 3 Jul 2001, Jon Stevens wrote: It's just sad when an organization like Apache chooses to ignore existing standards and invent it's own DTD and transformation language to do the site. Once again Costin, you fail to impress me with your statements. You confuse Apache with some

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-02 Thread Geir Magnusson Jr.
This is deja vu all over again. We should take one copy if this discussion (we had the same thing in Commons, and I am sure it happened everywhere else...), post it somewhere, and people can just submit article numbers or something rather than typing the same arguments over and over. Yes, I

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocumentation Redactors To Hire]

2001-07-02 Thread Geir Magnusson Jr.
Brad Cox wrote: At 10:09 AM -0400 7/2/01, Rob S. wrote: 1) Developers don't write them in lieu of coding. 2) Users don't read them 3...) ? http://www.c2.com/cgi-bin/wiki has a novel way of getting at the problem. Not a panacea obviously, but what is? The one at that address is

Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:[TomcatDocumentation Redactors To Hire]

2001-07-02 Thread Pier P. Fumagalli
Geir Magnusson Jr. at [EMAIL PROTECTED] wrote: Documentation is just as valuable as the software... Probably even more... It allows more dummies to install our software, more dummies = more bugs found, more bugs found = more fixes, more fixes = better software... Or that's right only in