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

From: Date: Fri, 09 Jan 2004 21:36:18 +0000
Subject: #494 [Opn->Asn]: PEAR manual needs user comments or examples per method
References: 1  Groups: php.pear.webmaster 
Request: Send a blank email to pear-webmaster+get-1213@lists.php.net to get a copy of this message
ID: 494 Updated by: mj@php.net Reported By: ramses0 at yahoo dot com -Status: Open +Status: Assigned Bug Type: Web Site Operating System: Linux PHP Version: Irrelevant -Assigned To: +Assigned To: toby New Comment: Tobias Schlitt is working on that. Previous Comments: ------------------------------------------------------------------------ [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

« previous php.pear.webmaster (#1213) next »