Sphinx Autosummary and Bob's documentation
Created by: anjos
I'd propose we stop having our manuals with every submodule including all methods and classes in that submodule, and went more like the manuals for NumPy and SciPy (http://docs.scipy.org/doc/numpy/reference/routines.math.html) in which every method or class gets its own dedicated page, with an upfront summary. This can be done with the sphinx autosummary extension (http://sphinx-doc.org/latest/ext/autosummary.html).
That should make it easier to browse and reference to our documentation.