News Feed
Sections




News Archive
Looking for more information on how to do PHP the right way? Check out PHP: The Right Way

SitePoint PHP Blog:
Keeping Your PHP Code Well Documented
February 19, 2014 @ 10:15:19

The SitePoint PHP blog has a new post by Jacek Barecki talking about documenting your code and some suggestions for keeping this documentation useful.

Pretty much every PHP developer writes comments along with the actual code. But the language itself doesn't impose any rules on how to do so. You just have to wrap them around some specific tags and then you can write any content you want. So what exactly should be put in the comment blocks to keep them useful? Which parts of the code should be documented and which shouldn't? In this article I will present some important rules which may help you in keeping your PHP code well documented and understandable.

There's three suggestions included in the article, each with a bit of explanation and a few screenshots to illustrate:

  • Write code that explains itself
  • Keep the balance
  • Remember about the doc blocks
0 comments voice your opinion now!
documentation understandable useful tips tutorial

Link: http://www.sitepoint.com/keeping-php-code-well-documented/

blog comments powered by Disqus

Similar Posts

Piotr Walczyszyn's Blog: Configuring Eclipse PDT & Flash Builder 4 Plug-in for PHP/Flex development

Maggie Nelson's Blog: NTILE() - easy way to generate tag clouds

OpenShift Blog: Integrate PHPStorm and SFTP into OpenShift

Robert Basic's Blog: Data filtering with PHP's Filter extension

PHPMaster.com: Aura.Web: Aura’s Page Controller for MVC


Community Events





Don't see your event here?
Let us know!


security community voicesoftheelephpant composer tool laravel library mvc package series update framework opinion interview language podcast symfony introduction version release

All content copyright, 2014 PHPDeveloper.org :: info@phpdeveloper.org - Powered by the Solar PHP Framework