turned the comments into docstrings