Shorten docstrings

[pavelkomarov]

Right now each parameter to a function is documented with a description on one line, its type on the next line, and a newline before the next one. It's possible to do these in one line in a way Sphinx will understand, which keeps the user from needing to scroll as much while examining the source code. As I go through the code, I'm trying to adopt more of a numpy style. I'll have to look at the CI to figure out how the docs are getting built and make sure I'm not breaking anything.

As I add parameters to functions, I'm having to change docstrings anyway, so this is a natural thing to touch.

[pavelkomarov]

I've been running make html from the docs folder to ensure my docstring changes are understood by sphinx and render the way I want. I consider documentation to be all-important, so these are a big priority for me.

[pavelkomarov]

I'll call this done after #102, #98, and #106. That will cover all the user-facing docstrings, which are the really lengthy ones.