small update to README and local.yaml
Tweak README edits
Merge Schalk's readme edits that smooth the new-user experience.