I am a user. I have been following (lurking actually) the discussion on documentation.
Until the "developers" make sure that the objects that are developed at jakarta are documented so a typical user can use them, they will not be widely used. I would like to use many of these tools, but don't have the time to dig them out, and reverse engineer them. So, I just write my own, like everyone else. IMHO, until the documentation is made part of the formal committing process, the jakarta tools will only be valuable to the people who developed them. I know that I am opening myself up to a serious flame, but that is the way I see it. Jim Scott ----- Original Message ----- From: "Paulo Gaspar" <[EMAIL PROTECTED]> To: "Jakarta Commons Developers List" <[EMAIL PROTECTED]> Sent: Monday, January 07, 2002 10:49 AM Subject: RE: Commons Validator Packaging/Content > No. We simply have more developers than users. If we had more users who > turned into developers, we might have more documentation. Whatever is the cause of the documentation problem, this is the reason why people are not aware of those components. If Turbine and Avalon would have Velocity-like documentation quality... I am just trying to put my finger on the issue. If the developers of such components are aware of this, maybe they make an extra effort to create better documentation since the start. I mean, that is what I will try to do - being aware of this - when I (finally) release one of my components since I want as many people as possible to use it. And most other developers just want the same. BTW, isn't most of Velocity documentation created by its developers? =;o) Have fun, Paulo Gaspar > -----Original Message----- > From: Jon Scott Stevens [mailto:[EMAIL PROTECTED]] > Sent: Monday, January 07, 2002 5:11 PM > > > on 1/7/02 3:35 AM, "Paulo Gaspar" <[EMAIL PROTECTED]> wrote: > > > <flame-bait> > > That sure is one of the reasons why people from projects like > Turbine and > > Avalon end up asking things like: > > - Why didn't you use mine??? I have one of those!!! > > > > Their overview documentation does not help much and not everybody goes > > browsing the Javadocs. > > </flame-bait> > > > > No. We simply have more developers than users. If we had more users who > turned into developers, we might have more documentation. > > -jon -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]> -- To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]> For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
