improved docstrings as per suggestions