add docstrings to utility functions