@mmasnick @husbandpanda Thanks for reading! The entire point is that those reasons are circularly justified and are not valid.
The sole thing you need to know is that instead of just doing an OpenAPI spec, which is the standard for documenting HTTP APIs, they invented their own that has no language support and can be expressed as a subset of OpenAPI + JSON Schema!