Re: On PEAR quality issues and natural selection

On Fri Apr 09, 2004 at 10:0948AM -0500, Richard York wrote: > Documentation on documentation is another lacking area of PEAR, there's > a link to the docbook website, but no explaination of how to write > the bloody documentation, nor of how to access CVS and place it in CVS. > You can get a CVS account, but no explaination of how to use it. No > examples of well formed docbook xml, PHPDcoumentor is good, but its > not PHPDocumentors job to explain how to add code snippets and tables > and all that. The lack of documentation is surely a problem. But (this may sound like a cheap excuse now) there is about nobody who has enough time to write all the necessary documentation. So if there is anybody, who wants to make the world a better place, please get in touch with pear-doc@lists.php.net. > I also feel the code structuring guidelines should be expanded to include > the one true brace convention, on all control structures, not just > functions... this other convention is difficult to read and most > professionals don't use it (at least none that I've encountered). I guess this is pretty much personal taste. -- - Martin Martin Jansen http://martinjansen.com/