Re: phpdoc comments (was: taking care of tomas's packages)
| From: | Lukas Smith | Date: | Wed, 25 Feb 2004 13:16:43 +0000 |
| Subject: | Re: phpdoc comments (was: taking care of tomas's packages) | ||
| References: | 1 2 3 4 5 6 | Groups: | php.pear.qa |
| Request: | Send a blank email to pear-qa+get-655@lists.php.net to get a copy of this message | ||
David Costa wrote:
You are very welcome. Just for the record I have committed yesterday the Net_SMTP package documentation. Wouldn't be a good QA suggestion to ask, for new packages, some phpdocumentor compatible comments? That would make PEAR documentation more comprehensive. For example, I suspect that for http_upload some of the bugs are not really bugs but just something that could be cleared with the documentation and examples. I will try to prepare the http_upload documentation.proper phpdoc comments are a CS requirement. However not everybody does that properly and alot of people dont use the new features. The biggest problem seems to me that new developers take existing packages as examples and so they mistakes increase exponentially. If we ever get all of PEAr cleaned up I assume that we will have much fewer new issues. So the sooner we get this fixed the better. This goes along the lines of what I just posted on pear-dev about applying CS fixes for package maintainers. regards, Lukas Smith smith@backendmedia.com _______________________________ BackendMedia www.backendmedia.com berlin@backendmedia.com Linn Zwoch Smith GbR Pariser Str. 44 D-10707 Berlin Tel +49 30 83 22 50 00 Fax +49 30 83 22 50 07