jon * wrote:
>
> ....do not have the luxury of hiring
> people to sit around and do newbie documenation.
> ....we do our
> best to document the code and provide Javadoc as well as provide working
> stable code.
I don't dispute the validity of your code or the Javadocs Jon, not at
all.
> It is up to other people to help us finish up the rest of the
> project documentation........ we kind of expect the users to be resourceful
> enough ....
I agree in that developers such as yourselves should be totally and
utterly insulated from the outside world. You are undoubtedly your most
effective in this mode.
But for software to stand up in the marketplace, surely it has to be
usable to the most appropriate amount of people? Didn't HTML 'take off'
as a page creation/web publishing tool only when people wrote good
HOWTO's and 'newbie' guides? Surely a goal of yours and the whole Apache
project is for your code to be used by as many people as possible? Why
not make it easier to do so?
> It is totally unfortunate that not one single one of those people is willing to
> stand up, help out and provide more documentation (what are you people doing
> on this list???).
I'd agree with that and to be honest my reaction now is to offer to
create some HOWTO-like documentation and offer it up to the project.
Would this be useful?
Look at it another way, I had two set's of HTML generation classes in
front of me. I chose the one that was easiest to adopt. It was as simple
as that.
To re-iterate a point I made earlier, I am new to Java, but I'm not new
to web development. I picked up servlets easily and have built database
driven intranets quite successfully. But my stumbling block was ECS, so
I had to go around it. I'd love to use it because of it's functionality.
> So, I apologize for falling short for you.
Jon, please don't take my rantings personally. I understand that you are
a developer and it's more useful for you to remain so. I view this as a
shortcoming of the project, not yourself personally. Is it that no-one
wants to write documentation or is there a view that it's not necessary?
Simon
--
Simon Allaway - University of Chicago
[EMAIL PROTECTED] - 2-7768
--
"I'm against animal testing. They just get all nervous
and get the answers wrong."
--
------------------------------------------------------------
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Archives and Other: <http://java.apache.org/main/mail.html>
Problems?: [EMAIL PROTECTED]
