docstrings are a good thing

begin to update docstrings to reflect problem statements