phpDocumentor authors
The release of phpDocumentor 1.2.0+ marks a radical shift in the design philosophy of phpDocumentor. No longer is this tool intended only to generate documentation from the source code. Now it facilitates generating user-level documentation for people who only wish to use your software, and not to modify it. This allows complete integration of all the documentation for the software project, and that means even greater ease of documenting, and ultimately more time to work on making the software work!
The old functionality of phpDocumentor has not been changed, only extended. The old HTMLdefaultConverter has been ported to a new HTMLframesConverter. The output looks the same, or better, but the templates are now smarty.php.net-based templates, and allow much greater customization. To start out right away, read phpDocumentor Tutorial.
If you think you've found a bug in phpDocumentor, please check our bug trackers online at PEAR and http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=111194 Sourceforge, the bug may have already been fixed (we develop at a rapid rate). If you don't find it, please submit a bug (preferably at PEAR), and we will attempt to fix it as quickly as possible.
If there is a feature you're dying to have, check our feature tracker at PEAR and http://sourceforge.net/tracker/?func=browse&group_id=11194&atid=361194 Sourceforge. Please don't hesitate to look right at the source code and help apply your feature. We love that, and can easily give you access to the cvs.
If you would like to help out with phpDocumentor, don't be shy. Email Joshua Eichorn right away and say you'd like to be added to the developer team. We need people who are willing to develop Converters, translate documentation, and handle various bugs and feature requests as they come up. phpDocumentor is fast becoming the de facto standard of automatic documentors in PHP, so it is in your best interest to make sure it works the way you need it to work.