I was just reading through the list of changes in Drupal 7 UNSTABLE-4 (http://drupal.org/node/224333#UNSTABLE-4), and was super excited to see the new standard for documenting hooks in a _module_.api.php file. The Drupal hook system is amazingly useful, but there has never been a solid standard for explaining what they do, ad especially what parameters they take. And there isn't a single syntax for defining a hook, so I would often find myself having to fire up the debugger just to track down where the hook was being called from so I can see if there were any illuminating comments.
Check out the "system.api.php file that documents all the core Drupal 7 hooks":http://cvs.drupal.org/viewvc.py/drupal/drupal/modules/system/system.api.php?view=markup Really exciting stuff, and the kind of attention to detail that shows how much the Drupal project is maturing.
Awesome! Thanks for
Awesome! Thanks for bringing this to my attention. I was just documenting hooks yesterday for some additions to the Ubercart Google Analytics integration module and stuffed 'em into our ever-growing hooks.php. This'll help keep that under control. :)