changes in readme and docstrings