These are chat archives for APIs-guru/api-models
I manually fix and review specs and it easier to do in YAML.
Why manually? Can not swagger-parer do it?
Also in my experience 80-85% of specs have some kind of mistakes in them.
I have messy script which fix some of the simple mistakes automatically. But in many cases I need to make my hands dirty and fix them manually you can see this fixes as
fixup.yaml files in repo. For example this one.
And finally I automatically update specs almost every day and manually inspect diffs to see that update didn't break anything.
In the future I am going to support Yaml schemas, so at the some point would be nice to have one file with all link to Yaml schemas.
I don't see a way how I can fit both JSON and YAML into APIs.json format.
But you can use my REST API it already have links to both formats.