A Module which describes other modules I am working on a module which is able to automatically generate a developer document based on the hooks, menus, files and other attributes it holds.

Often when we install a new module, We need to search for the configuration options provided by it. So by automatically generating a document, this issue will be solved. 


I started working on this based on clive's suggestion in the post (Get a particular module's information programmatically)
I could retrieve the menu links created by a module as clive suggested in that post.
To retrieve hooks used in a module, I used the PHP function token_get_all() to get all function used in a file and checked whether its a hook.



  Now, I need some suggestions about what can you know by looking through a modules file. What else in a module file can help one
  understand a newly installed module better?
  
  Is there any API's to get information about a hook from drupal.org?
Now there is a module for that ;) It's the Developer Docs module.
Here's a brief description about it (from its project page):

Developer Docs is a module specially made for drupal developers (amateur). When a new module is installed, it is hard to find what changes it does unless we look into the code. This module provides an overview of &quot;what it does&quot; without looking into the code.
This Module generates a document automatically based on the drupal elements used in the module such as:

Administration menu
Hooks
Database Schemas
Themes
Variables
Blocks
Node types
Entity Types
Fields (Formatter, Widget)
Field Formatters
Field Widgets
Hooks Created

After enabling this module, list of installed modules will be available at admin/reports/developer-docs/