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
```

We haven't been doing that elsewhere consistently (*many* arguments are optional, e.g. in `Canvas`). We should probably decide if we want to add it and if so, do a whole-repo sweep at some point.