News Feed
Sections




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

PHPMaster.com:
Generate Documentation with ApiGen
August 02, 2012 @ 09:44:43

On PHPMaster.com today there's a new tutorial showing you how to generate API documentation with the help of the ApiGen documentation tool and some commenting in your code.

If you're writing undocumented code, you should stop this very moment. I'm serious. Drop everything, save and quit, and focus on improving this essential part of your workflow. [...] ApiGen is a docblock parser like PhpDocumentor. PhpDocumentor has been around for much longer than ApiGen, but unfortunately its development is somewhat stunted and it lacks in terms of modern documentation and examples.

He shares an example class, fully commented to show off the right way to handle the DocBlocks and goes through each of the "@" types and explains what they're for. Also included are the instructions for getting ApiGen installed (via the PEAR installer) and a sample command to generate the docs from the source. You can find out more about ApiGen and some of its other options on it's main site.

0 comments voice your opinion now!
api documentation tutorial apigen docblock parse tool


blog comments powered by Disqus

Similar Posts

Felix Geisendofer's Blog: Screencast #1: Using vendor branching and CakePHP

DZone.com: The Best Unknown Databases for PHP Apps

Pádraic Brady's Blog: XSS in PHP (Part 1): How Not to Use Htmlspecialchars

Matthew Leverton\'s Blog: How to add a custom CAPTCHA to phpBB2

Brian Swan's Blog: Getting Started with PHP and SQL Azure


Community Events





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


developer install unittest refactor threedevsandamaybe list configure framework testing series interview language laravel opinion release community experience code introduction podcast

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