Fix a couple of minor docs errors
give an example of env var substitution
Some other README edits and updates