This will let the YAML vscode plugin (and anything else using yaml-language-server) provide a much nicer experience including validation, autocomplete, and hover documentation.
When we do this, we should consider either adding the schema association with *.idl files (which will only work in vscode) or add the magic comment to each idl file.