minor updates to readme and docstrings