Mailing-List: contact tomcat-dev-help@jakarta.apache.org; run by ezmlm
Precedence: bulk
Reply-To: tomcat-dev@jakarta.apache.org
From: "Rob S." <rslifka@home.com>
To: <tomcat-dev@jakarta.apache.org>
Subject: RE: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS: [TomcatDocu
 mentation Redactors To Hire]
Date: Mon, 2 Jul 2001 21:25:40 -0400
Message-ID: <NEBBKCJBPLLPNFMKLPAJCEMADHAA.rslifka@home.com>
MIME-Version: 1.0
Content-Type: text/plain;
	charset="iso-8859-1"
Content-Transfer-Encoding: 7bit
In-Reply-To: <3B411A21.FEB6288D@mhsoftware.com>
Importance: Normal

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, it works for Struts ==> it'll probably work for Catalina.

Committers, [VOTE] on this?

- r

> -----Original Message-----
> From: Christopher Cain [mailto:ccain@mhsoftware.com]
> Sent: Monday, July 02, 2001 9:05 PM
> To: tomcat-dev@jakarta.apache.org
> Subject: Re: [PRE-PROPOSAL] jakarta-tomcat-doc sub-project : WAS:
> [TomcatDocu mentation Redactors To Hire]
>
>
>
> Jon Stevens wrote:
> >
> > The Tomcat website is already generated with Anakia. It is
> trivial to add
> > more .xml files to the site and there is absolutely no excuse
> to not just go
> > that route.
> >
> > I just don't see the merits of this discussion. Go write documentation
> > instead.
> >
> > -jon
>
> LOL.
>
> Oh, well then, as long as _Jon_ doesn't see any merits, I guess this is
> all just so much fodder. Never mind that the question has not yet been
> adequately answered, and is still being constructively debated. Never
> mind that some program I never heard of generates the Tomcat site. Never
> mind that what happens on the Apache servers has about as much to do
> with Tomcat documentation, which is being discussed as a new context
> installed with the server, as what I plan on feeding my cat Mittens
> tonight. Never mind all that ... Jon has descended from the Ivory tower
> with his rather cryptic edict. Once we make sense of this devine wisdom,
> we are to proceed immediately and without question.
>
> For someone who loves to speak at great lengths about community
> discussions and honoring majority decisions, this is a rather bizzare
> tact to say the least. Some of us, including myself, would like for this
> discussion to come to a well-considered conclusion so that we can help
> out with documentation. Your nonsensical suggestions and irritation at
> being bothered with this thread are both completely irrelevant, Ace. I
> have no interest in Anakia, and quite frankly, as has been pointed out
> very astutely by Costin, I have no interest in bothering with XML for
> the purposes of documentation. I will produce HTML docs with my favorite
> editor and call it a task adequately completed. Asking anything beyond
> that will more than likely be more time and effort than I am prepared to
> invest in simple documentation.
>
> In short, let us please continue and decide upon how to proceed.
> Regardless of Jon's off-topic confusion, I would really like to know how
> the community would like to see any documentation which I may
> contribute.
>
> - Christopher
>