More docs on environment variable substitution
Doc: clarify example
Merge pull request #1263 from matthewrmshin/more-docs-on-env-subs

More docs on environment variable substitution