docs: Update config docs in README for new Consumer API

[timmc-edx]

Also a bit of cleanup.

Merge checklist: Check off if complete or not applicable:

• [x] Version bumped
• [x] Changelog record added
• [x] Documentation updated (not only docstrings)
• [x] Commits are squashed
• [x] Noted any: Concerns, dependencies, deadlines, tickets, testing instructions