[#1668] Add better docs and defaults to general.yml-example

@crowbot before I go on with more of this are you +1 on the idea and format?