add explanatory comments to config.yml.example