some fixes in readme
improve docstrings for class methods, close #2
add class representation