tons and tons of refinements and additions to docs

doc/conf.py

@@ -140,6 +140,8 @@ html_sidebars = {'index': 'indexsidebar.html'}
 # Additional templates that should be rendered to pages, maps page names to
 # template names.
 #html_additional_pages = {}
+#html_additional_pages = {'index': 'index.html'}
+
 
 # If false, no module index is generated.
 #html_domain_indices = True