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

ID: 494 User updated by: ramses0 at yahoo dot com Reported By: ramses0 at yahoo dot com Status: Analyzed Bug Type: Web Site Operating System: Linux PHP Version: Irrelevant Assigned To: toby New Comment: 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! Previous Comments: ------------------------------------------------------------------------ [2004-01-09 17:00:26] toby@php.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@php.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