As we have already discussed the significance of source documentation, the documentation should be presented to a general user in a well-organized way or graphically elaborated using HTML pages. Such API documentation, converted from source DocBlocks, can be the technical documentation used for learning about the source. NetBeans comes with the support to generate API documentation from the PHP source for the entire project using the ApiGen auto documentor tool.
ApiGen is the tool for creating API documentation using the PHPDoc standard, and supports the latest PHP 5.3 features, such as namespaces, packages, linking between documentation, cross referencing to PHP standard classes and general documentation, creation of highlighted source code, and support for PHP 5.4 traits. It also generates a page with trees of classes, interfaces, traits, and exceptions for the project.
Note
Check out the ApiGen features at http://apigen.org/##features.
In the next section, we will discuss...