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.