[PEPr] Comment on RFC::Amendment of Docblock Comment Standards
| From: | Brett Bieber | Date: | Wed, 12 Nov 2008 21:59:58 +0000 |
| Subject: | [PEPr] Comment on RFC::Amendment of Docblock Comment Standards | ||
| References: | 1 | Groups: | php.pear.dev |
| Request: | Send a blank email to pear-dev+get-51071@lists.php.net to get a copy of this message | ||
Brett Bieber (http://pear.php.net/user/saltybeagle) has commented on the proposal for RFC::Amendment
of Docblock Comment Standards.
Comment:
I think @return should be kept, and the @param var names ensure you are
documenting the correct parameter.
As a side note, the constitution states that Coding Standards are the
purview of the PEAR Group. Keep the discussion going, but keep in mind
you're asking the PEAR Group to make changes.
Proposal information:
http://pear.php.net/pepr/pepr-proposal-show.php?id=580
--
Sent by PEPr, the automatic proposal system at http://pear.php.net