tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Christopher Cain <cc...@mhsoftware.com>
Subject Re: Suggestions (was Re: hello everyone (regarding documentation))
Date Tue, 10 Jul 2001 22:52:48 GMT

Alex Fernández wrote:
> 
> Hi Hiten!
> 
> hiten pandya wrote:
> > i am planning to start my own documentation project for Tomcat 3.3 and 4.0.
> > The different thing about this project is that, i am going to port all of
> > the tomcat documentation to XML Docbook format.
> 
> Not speaking officially, I'm not a committer: if you want to document
> Tomcat, then go ahead and good luck!
> 
> Your focused work can do lots for the docs: you will probably end before
> the "committee" decides the right format for Tomcat docs :)

LLAMF! True that.

> Just a suggestion:
> > Though i am not very good at docbook but i think i can cope. Once the
> > documentation is complete, I will submit it to the main tomcat development
> > team.
> 
> Don't wait till everything is ready; send your updates regularly to the
> dev list, so folks can criticize your work and point possible mistakes.
[snip]

Am I the only one that initially read that as "send your updates
regularly so that folks can criticize you and your pointless mistakes"?
Alex deals some very sage advice here, but when I first hit "Reply" he
was about to get some even higher praise for the funniest pointed
sarcasm I had heard in quite some time.

...

Uhhh ... I guess you had to be there. In any event, Alex's advice is
quite sound, FWIW.

Mime
View raw message