Rewrite README and include as "about" in docs

We don't use this format anywhere else. For page titles, it's over and under `#` to follow the python documentation standards.