> -----Original Message-----
> From: Jon Stevens [mailto:[EMAIL PROTECTED]]
> Sent: Saturday, January 06, 2001 04:16
>
> Because it isn't my itch to scratch. The software works fine for me and I
> understand it perfectly well.
Community driven!
> I make time to correct. I haven't flamed you at all.
You didn't?
> You are just on the
> defensive over an email and someone you have never even met face to face.
> How weird is that.
As weird as the exhaustive answer... but point taken.
> I'm simply having a conversation.
Sure.
> Like I said already. Suggestions are not helpful. It is like
> putting the job on someone else shoulders.
Ist it? Am I doing that?
> Telling us that we need more documentation isn't anything that we don't
> already know. Duh.
Ah... you do?
> > Notice that I am not demanding this or that. I am aware that Tomcat
> > is (mostly) volunteer work.
>
> Ah. But you are demanding.
Am I? (Learning a lot tonight!)
> You are saying things like:
> > Tomcat has the same problem as Struts and most Open Source
> > projects (it is not just an Apache thing):
> > * NOT ENOUGH DOCUMENTATION *
>
> In case you missed it UPPERCASE and ** is like yelling at us
> saying that we
> need more documentation.
>
> If you had said something like:
>
> "The Tomcat project needs documentation in the following areas: blah blah
> blah."
If you found the Uppercase, I am sure you can find the areas I mentioned
too.
> > It is not even something fancy - just remembering to spend some extra
> > 5 minutes of effort at the right moment:
> > - I suggested turning project specs and proposals that are posted
> > here (and in other Apache projects) into documentation in the
> > distribution (of this and those other projects).
>
> Wow. That is such a GREAT suggestion! I'm surprised that no one here would
> have ever though of such a mind blowing improvement!
I am surprised too.
> I will work
> as quickly
> as I can do go over all of the archives and implement exactly
> what you say!
Then you missed the point:
- "at the right moment";
- "Turning such postings into documentation is something very easy to do
just at the time those texts are approved... and very hard afterwards".
> > I am not even asking great documentation as FreeMarker has (and it is
> > GPL). Just posts turned into documents with basic editing.
>
> Lol. I thought FM's documented sucked.
Much more "up to the task" than any Apache project I know of.
(But of course that it is a small project.)
> You have this assumption that myself or other people on this list are
> supposed to jump up and suddenly take your earth shaking ideas
> and implement
> them. Not.
Do I?
> > Do you want to draw a line on what is good documentation?
> > Look at FreeMarker. Doesn't even have to look so nice.
>
> That documentation sucks and the project is dead. What is to envy about
> that?
The project is good enough at what it does. And the docs too.
> Yep. Sucks doesn't it? Why don't you contribute some documentation to help
> improve it?
Is it my turn to jump and do what you say.
Did I sound as mush "pushing" to you as you are sounding to me?
Ok, had enough.
Have fun (you realy need it),
Paulo
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, email: [EMAIL PROTECTED]
