update documentation for new docstrings