more docstring improvements