better YAML formatting in a couple of key documents