Reorg configuration section and other misc doc improvements.

Well, I punted on getting the warnings to go away, because Sphinx, but this at least improves the config documentation experience considerably.