Expanded docs

We still need better overview and getting started pages (with examples!).

I also updated a number of docstrings so they can appear in the API reference.

Note: I spent a little bit of time trying to get building docs setup on readthedocs.org, but I have not yet been able to get it to work with the necessary dependencies (notably, numpydoc).