- added better docstrings