Add .. index:: directives to populate genindex.html

I'm trying to make the documentation searchable in [Dash](http://kapeli.com/dash), no luck so far, even so, this `genindex.html` is rather handy.

I also introduced two newlines between subsections in the document, this way it's easier to tell where one method's documentation starts and the other ends.