Posted by jhodgdon on February 22, 2010 at 3:58pm
There's a discussion going on about standards for documenting classes and interfaces in the Drupal API -- please comment on the issue (and NOT here) if interested:
http://drupal.org/node/718596