On Monday 02 October 2006 18:37, Ilias Lazaridis wrote:
> > -- documentation is a big plus.
>
> again, can be provided incrementally

Experience shows that this almost never happens. Once someone gets his pet 
code integrated, they never care to document it. They know how it works 
and don't need documentation, so they don't bother.
What is worse is that (in my experience) they don't even return to 
maintain their code (in case it was something more than a bug fix) and 
the original author is forced to fix and maintain their code later.

Currently the SQLObject documentation is scarce. There are so many things 
you can only find out about if you read the source, and there are things 
in the existing documentation that are no longer accurate and can be 
misleading. And I haven't seen any incremental addition to them, but 
while I read the code I discover new undocumented things added regularly.

-- 
Dan

-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
sqlobject-discuss mailing list
sqlobject-discuss@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/sqlobject-discuss

Reply via email to