Re: PEAR Documentation coverage analysis
| From: | Martin Jansen | Date: | Wed, 18 Oct 2006 18:30:18 +0000 |
| Subject: | Re: PEAR Documentation coverage analysis | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-44634@lists.php.net to get a copy of this message | ||
On Wed Oct 18, 2006 at 07:3450PM +0200, Christian Weiske wrote:
> documented in the manual and generates some statistics. The extendet
> version also shows which classes and methods are documented.
I don't think we should strive for this sort of doc coverage. The API
of all classes is documented pretty well via the auto-generated API
documentation. Instead the peardoc documentation should provide
examples, tutorials etc. for which it is not necessary to document each
and every class and method.
- Martin