one liner docstrings under each of these functions would help (I tried added this as one big docstring in the PR i just submitted)