docstrings for all the new methods
removed replaced code
just some comments