doc updates
updates to README and docstrings