some more cleanup of the docstring