Update docs

@keflavich @ChrisBeaumont - I've tried to tidy up the documentation a bit. What do you think?
typo: pass->path

and the data _are_?