Re: Documentation..
| From: | Greg Beaver | Date: | Tue, 16 Nov 2004 05:29:27 +0000 |
| Subject: | Re: Documentation.. | ||
| References: | 1 2 3 4 5 6 7 8 | Groups: | php.pear.qa |
| Request: | Send a blank email to pear-qa+get-1948@lists.php.net to get a copy of this message | ||
Paul M Jones wrote:
On Nov 15, 2004, at 9:59 PM, Greg Beaver wrote:no API docs is a bug. No verbose tutorials is a feature request. Would you say that PEAR_PackageFileManager has no documentation? It is 99% API docs, but as a part of API documentation, there is a usage example for important methods. The two kinds of documentation are not mutually exlusive. I like tutorials, but they are not essential to understanding 99% of packages. What really matters is knowing how to use a method/class and what the expected usage is. The rest is candy for people who are also learning how to program at the same time. GregDavid Costa wrote:<opening mouth> I think we mean end-user documentation here, not just API docs, to include short narrative description (3-4 sentences or a couple of paragraphs?) and getting-started examples. <closing it up again>David Costa P.S. we can open a bug report for every non documented package in the stable branch.. if that helps...very good. lack of documentation for anything "stable" is by definition a bug, because the API is not defined, so BC is already broken any time a bug is fixed :)