incorporate comments into docstrings