updated docstrings