touched up docstrings and removed a TODO.
put an actual module docstring.