docstrings completed