STY: Improve look of README
DOC: Typos, make valid rst docstrings.