docs & docstrings updated