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

From: Date: Thu, 25 Dec 2003 23:50:37 +0000
Subject: #494 [NEW]: PEAR manual needs user comments or examples per method
Groups: php.pear.webmaster 
Request: Send a blank email to pear-webmaster+get-1075@lists.php.net to get a copy of this message
From: ramses0 at yahoo dot com Operating system: Linux PHP version: Irrelevant PHP Bug Type: Web Site Bug description: PEAR manual needs user comments or examples per method 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 bug report at http://pear.php.net/bugs/bug.php?id=494&edit=1 --

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