Readme updates

Opened for discussion...
If you put this stuff in `CONTRIBUTING.md`, github will link to it in the pull request UI