I know I am a broken record on this:
Documenting your work is a part of writing code, just like writing unit tests. Code without documentation is useless. :) > 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. :-) > > (Yes, I realize Torque is now apart of Apache DB, but it came from an even > worse documented project in Jakarta, Turbine) > > <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. > > 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. > </mini-rant> > > Thanks, > Patrick > > > > > ------------------------------------------------------- > 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 > ------------------------------------------------------- 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
