Docstring Updates

[lwasser]

Many docstrings are missing parameter and return values. This information is actually really helpful when working on the package because you don't know what type of path / object the functions expect and have to run everything to figure it out. We should chip away at this as we work on cleanup.