Improve README for site yaml files
Merge pull request #831 from alphagov/improve_docs_for_site_yaml_files

Improve README for site yaml files