Guidance-oriented listener documentation

[nightkr]

Currently the documentation is very focused on the "here's a bunch of options", but we also need to document when those options are appropriate, which takes a more fundamental understanding.