> are there no existing languages comprehensive enough for this?
In my experience, RAML[0] is worth adopting as an API specification language. It is superior to Swagger/OpenAPI in both being able to scale in complexity and by supporting modularity as a first class concept:
RAML provides several mechanisms to help modularize
the ecosystem of an API specification:
Includes
Libraries
Overlays
Extensions[1]
In my experience, RAML[0] is worth adopting as an API specification language. It is superior to Swagger/OpenAPI in both being able to scale in complexity and by supporting modularity as a first class concept:
0 - https://github.com/raml-org/raml-spec/blob/master/versions/r...1 - https://github.com/raml-org/raml-spec/blob/master/versions/r...