Converting docstrings to numpydoc

Some work done on issue #466.

There are some cases I am not sure of.

I'll squash more commits to this pull request later.
What should I do here with this super long type?