Merge pull request #635 from OAI/issue-575

clarification about YAML