update docstrings for a couple functions