[Phpmyadmin-devel] Writing useful docblocks

Michal Čihař michal at cihar.com
Tue Jun 19 11:07:55 CEST 2012

Hi all, especially GSoC students

just a quick reminder, that docblocks are meant to document function
and it's parameters, so writing docblocks as following is quite useless:

     * @param type $srid
     * @param type $scale_data
     * @param type $output

- You should describe what the function is supposed to do
- You should document actual types of parameters instead of writing
  there "type"
- You should document parameter meaning

Thank you for your cooperation in making readable and easy to
understand code.

	Michal Čihař | http://cihar.com | http://blog.cihar.com
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: not available
URL: <http://lists.phpmyadmin.net/pipermail/developers/attachments/20120619/fc590fef/attachment.sig>

More information about the Developers mailing list