5 ms·
One of the criticisms of OpenAPI is the verbosity of the schema definition. I've seen a couple of meta generator projects that generate OpenAPI specs from a me
by mintyc 7y ago
One of the criticisms of OpenAPI is the verbosity of the schema definition.
I've seen a couple of meta generator projects that generate OpenAPI specs from a meta description.
Is anything being done 'officially' to provide an abbreviated form for simpler use cases?
- codegladiator 7y agoWhy does it matter ? It's not supposed to be read by humans.
- augusto-moura 7y agoBut it's to supposed to be written by humans
- codegladiator 7y agoI think it is supposed to be generated automatically.
- tofflos 7y agoIt is supposed to be read by humans: "The format is easy to learn and readable to both humans and machines." Source https://swagger.io/docs/specification/about https://swagger.io/docs/specification/about
- deleted 7y ago[deleted]
- clhodapp 7y agoUnfortunately, actual usability seems to be getting ignored in the rush for a "standard". In the meantime, you might want to consider using RAML. It compiles to OpenAPI and is far more optimized for use by humans instead of machines.