Rewrite README and include as "about" in docs

There shouldn't be leading spaces and the `#` should be exactly as long as the text below/above it. You should see a warning about this when you try to build the documentation.