few changes to the docstrings