more updates to docstrings