improve docstrings + minor change to improve readability