DOC: updating formatting

Updating some of the formatting and docstrings, as well as tweaking
some function arguments.