Reword docstrings, fix a typo.

Thanks @kwmsmith, @cowlicks.