Dan Pascu wrote: > 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.
I see. Al this you've mentioned gives me the impression of a badly organized project. Basicly this starts from the project resources. I mean, trac is really a nice tool, especially for the python-domain. And I think every python project should have this front-end to the SVN. . -- http://lazaridis.com ------------------------------------------------------------------------- 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
