fall back to API files for hook body when there is no template?

I'm opening this one up for discussion as I am not sure whether or not this is a good idea.

For some hooks, the example code in the api.php file is a great starting point.

For others, it's just a demonstration of what can be done in that hook and in most cases if you got that chucked into your module code, you'd always be deleting it immediately (eg, http://api.drupal.org/api/drupal/modules--system--system.api.php/functio...).