make docstrings more verbose