Add docstrings

[keflavich]

I'll start playing with the functions as soon as there are some docstrings attached to them.

Also, tag me with @keflavich in anything that needs review or is ready for deployment testing.