Write configuration documentation

[rolandshoemaker]

A number of config behaviors may be non-obvious and could use some explanation (e.g. random proxy selection). Some kind of markdown configuration documentation would be good to have in tree so it doesn't drift out of sync.

This could also take the form of a better/fully annotated version of the current example.yml.