completed docstrings