Can you move this comment block up to right above the `class` bit? That will make it show up as class-level doc in rdoc. (example: http://rdoc.info/github/opscode/chef/Chef/EventDispatch)