housekeeping
adding docstrings here and there