Improve README for site yaml files

Done, rebased