Clean up docstrings

[falkowich]

Clean up docstrings with google or pypy style as guide.

• http://google.github.io/styleguide/pyguide.html
• https://numpydoc.readthedocs.io/en/latest/format.html#docstring-standard

[falkowich]

I will check this out as soon as #164 is done