updates documentation and docstrings