Update README

* add/updated bits that will make it easier for the next person to
  set up a dev environment
* fixed formatting so it's easier to read in text form