This is an idea that I came up with while developing a soon-to-be-released plugin. Not sure if it really makes sense, so I wanted to post it here to see what others thought.
For the past year or so, WordPress core has included inline documentation using phpdoc style syntax. I find this documentation to be very useful and am really happy that it was added. There are about 1,700 hooks (calls to do_action(), apply_filter(), etc...) that go unnoticed when parsed through phpdoc or phpxref. I think that it may be beneficial to developers if there was a way to tag the core code in a way where "automatic documenting scripts" could index functions by the hooks that they use. Kind of like
@uses but instead,
What do you think?