#494 [NEW]: PEAR manual needs user comments or examples per method
| From: | ramses0 at yahoo dot com | 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
--