doc formatting

converted simple comments into docstrings