Improve README for site yaml files

:+1: 

Also :+1: to the rendered diff button