add some function docstrings