They advocate for using JSON (with comments) over YAML: “Generating json as a better yaml Often the choice of format is not ours to make, and an application only accepts yaml. Not all is lost though, because yaml is a superset of json, so any tool that can produce json can be used to generate a yaml document.”