address pull request comments
- add more descriptive comments with examples
- simplify env variable expansion by using os.path.expandvars() instead of using os.environ
- use double-quotes for consistency
- remove references to phantom logging objects