An excerpt from http://www.sitepoint.com/making-your-wordpress-plugins-even-more-developer-friendly/ , by Tim Carr
In the last article, we looked at how Actions and Filters can be added to your WordPress plugins to help make them developer friendly.
Today, we’ll look at how to provide developer documentation.
Documenting Your Actions and Filters
It’s useful to document your WordPress plugin’s Actions and Filters, so that developers can quickly find what they need, as well as understand what each Action and Filter does.