improved docstrings