Update docs

@keflavich @ChrisBeaumont - I've tried to tidy up the documentation a bit. What do you think?
I'll need to let @keflavich fill out that info, as I'm not sure.