FIX: Fix docs

Closes #428.

Docs look good to me. Ready for review/merge. Can be viewed by doing:
```Bash
$ python make doc html && python make doc show
```

I don't think we need to repeat the args of the base class. DRY. But it would help to have a link to the base class(es) in the docs.