code style & docstring updates for utils.py
code style & docstring updates for utils.py

 * Minor style fixes.

 * Update formatting of docstrings to make Sphinx docs more
   cross-linked and browsable.

CenterForOpenScience/waterbutler,RCOSDP/waterbutler,felliott/waterbutler