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

ID: 494 Updated by: toby@php.net Reported By: ramses0 at yahoo dot com -Status: Assigned +Status: Analyzed Bug Type: Web Site Operating System: Linux PHP Version: Irrelevant Assigned To: toby New Comment: 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. Previous Comments: ------------------------------------------------------------------------ [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