refs #5: added docstrings to every existing function