Improve README for site yaml files

I'm trying to reflect the current state.