More docs on environment variable substitution

Partially address #1221.