add some more docstrings