#494 [Ana->Csd]: PEAR manual needs user comments or examples per method

Edit report at: http://pear.php.net/bugs/bug.php?id=494&edit=1 ID: 494 Updated by: danielc@analysisandsolutions.com Reported By: ramses0 at yahoo dot com -Status: Analyzed +Status: Closed Package: Web Site Operating System: Linux PHP Version: Irrelevant -Assigned To: +Assigned To: danielc New Comment: This was fixed a long time ago. Noticed bug now, so closing it. Previous Comments: ------------------------------------------------------------------------ [2004-03-12 10:18:48] toby at php dot net Sorry, guys, but I'm quite to busy to realize this in the upcoming weeks... Maybe someone else can take care of it. ------------------------------------------------------------------------ [2004-01-10 15:02:13] ramses0 at yahoo dot com Checked the toby at php.net url and could not figure out how to add comments. Will keep an eye on this, please keep me informed if you´d like feedback. Thanks for looking at this! ------------------------------------------------------------------------ [2004-01-09 17:00:26] toby at php dot net There is a proff of concept for that viewable at http:// zuhause.bei.tobias-schlitt.de:81/manual/en/ . This can at the moment only add new comments, which are directly viewable. I'll start implementing this today, with admin interfaces for package maitainers and website admins. ------------------------------------------------------------------------ [2004-01-09 16:36:18] mj at php dot net Tobias Schlitt is working on that. ------------------------------------------------------------------------ [2003-12-25 18:50:37] ramses0 at yahoo dot com Description: ------------ Witness the following: http://pear.php.net/manual/en/ package.database.db.db.iserror.php How is this to be invoked? Where is the example? Contrast this with the following: http://us2.php.net/manual/en/function.mysql-connect.php ...and: http://us2.php.net/manual/en/function.mysql-error.php PHP as a language is only as popular as it is because it has very well-written, user-supported (and user-supplemented) documentation. Have you programmed in Ruby lately? I appreciate the documentation that is out there, but I feel it is obvious that PEAR needs to encourage more user contribution to documentation, like the standard PHP documentation does. --Robert ------------------------------------------------------------------------ -- Edit this bug report at http://pear.php.net/bugs/bug.php?id=494&edit=1