Clarify docs, and fix spelling errors

- Use of capital APPNAME is super confusing, particularly when
  environment variables for "app" are customarily capitalized as
  `APP_`.
- Various spelling and markup fixes.
Merge pull request #15 from sam-github/docs-fixes

Clarify docs, and fix spelling errors