The coder module carefully checks whether a contributed module conforms to the Drupal code comment standards. However, Drupal.org is not doing anything with the code documentation. Perhaps automatically generated API docs can be generated for modules with a sufficient level of conforming documentation, much like PEAR does for its projects.
Idea No. 90