documentation & docstring updates