At 05:16 AM 8/29/2003 +1000, Gavin King wrote:>
I think its better to direct these questions to the dbcp guys; dbcp is, as
is usual for Jakarta stuff, extremely undocumented - but _someone_ must
know the answers to these questions.
So you to have noticed how most Jakarta projects aren't documented well...funny, Torque's lack of good docs is what got me looking at Hibernate. :-)
<mini-rant>
And to those in those projects who say "If you don't like the docs, then write some yourself", I have this to say: It's hard to explain to my boss why I am staring at source code writing docs when I am supposed to be trying to evaluate a product for our usage.
Put the other shoe on... jakarta developers have the same set of bosses/wives/children who don't accept explanations of needing to write docs.
If anything, I think it's a tribute to how good of a job the Hibernate committers are for doing this. As having been one of those lothesome Jakarta committers, who has told so many people that if they want something fix/doc'd to fix/doc it, I really appreciate how much Max, Gavin, Christian, et al do.
So in my case, bad docs get you dropped from contention pretty quickly. And the core developers (or people with the time) or the only ones that can write the documentation needed by normal people like me.
This implies you'd prefer people didn't donate source code unless they are prepared to doc it and meet other requirements. I would rather have the code in contention and then quickly dropped rather than never had that opportunity. I agree that value(docs) >= value(code), so you try to help when you can.
-- Serge Knystautas President Lokitech >> software . strategy . design >> http://www.lokitech.com p. 301.656.5501 e. [EMAIL PROTECTED]
------------------------------------------------------- This sf.net email is sponsored by:ThinkGeek Welcome to geek heaven. http://thinkgeek.com/sf _______________________________________________ hibernate-devel mailing list [EMAIL PROTECTED] https://lists.sourceforge.net/lists/listinfo/hibernate-devel
