adds some comments/docstrings