> -----Original Message----- > From: dank [mailto:dank] On Behalf Of Dan Kegel > Sent: Tuesday, March 26, 2002 7:27 PM > To: [EMAIL PROTECTED] > Subject: re: Using Avalon > > > I tried recently to understand Avalon. I was looking > for an FTP server written in Java, and the best one > I found mentioned that it was now the basis for the FTP > server demo for Avalon.
We have several CVS directories. Try the one in jakarta-avalon-apps--you should find it there. > I tried to find it, and failed. The Avalon docs are > so wordy, obtuse, pattern-obsessed, and self-important > that I wanted to vomit. Gee, thanks. Perhaps you would like to volunteer? You can't understand a framework until you understand what the thought processes are in that framework. Before I started writing most of that documentation, we kept answering the same questions over and over again. Guess what! The documentation represents the type of questions we had to answer. If you think you can do better, I invite you to do so. Personally, I have received far more compliments for the docs than I have negative comments. Furthermore, I have also received constructive criticism (which I respond to much better, BTW) and the docs have changed to represent that view. As a general rule, when you spew unhelpful comments like that, you hinder good documentation rather than help it. Documentation writing is a thankless job--don't bad-mouth people who actually do it (especially if you are not willing to take their place). > There may be some good stuff in Avalon, but they > need to shoot their doc writer and start over, IMHO. > - Dan See, that kind of negativity doesn't help. Try constructive criticism, it does miracles. BTW, They need to shoot the people who make mean spirited comments and start over. (Doesn't really sound nice does it?) -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
