[doc] proofreading the guides, refactoring the reference.

docs/conf.py

@@ -14,6 +14,7 @@ import bonobo
 
 extensions = [
     'sphinx.ext.autodoc',
+    'sphinx.ext.autosummary',
     'sphinx.ext.doctest',
     'sphinx.ext.intersphinx',
     'sphinx.ext.todo',
@@ -60,7 +61,12 @@ language = None
 # This patterns also effect to html_static_path and html_extra_path
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']
 
-# The name of the Pygments (syntax highlighting) style to use.
+
+autoclass_content = 'both'
+autodoc_member_order = 'groupwise'
+autodoc_default_flags =['members', 'undoc-members', 'show-inheritance', ]
+
+add_module_names = False
 pygments_style = 'sphinx'
 
 # If true, `todo` and `todoList` produce output, else they produce nothing.