docstrings refactored