more docstrings
fixed README