improving docstrings