README updates

A few style changes (roughly aligning with [markdown styleguide](https://github.com/carwin/markdown-styleguide)), notes on stumbling points, and changed the `git@github.com` to `https://github.com` so instructions work for those without GitHub accounts.