Hacker News Reader

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?

Unfortunately, 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.

Why does it matter ? It's not supposed to be read by humans.

But it's to supposed to be written by humans

I think it is supposed to be generated automatically.

It 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

Reply on news.ycombinator.com