improve YAML docs