Some updates/cleanups to the README
Note where the built docs
Merge pull request #2161 from asmeurer/readme

Some updates/cleanups to the README