[pb33f]

the k8s spec is machine generated, it's a terrible example of a contract that is not used by anyone really.

The purpose of this tool is for companies that operate API first, the contract is curated and then code, docs and SDKs are generated from it.

Code first is generally a bad idea, it's often terrible and non human readable and creates terrible SDKs that break constantly.

API first is a contract first approach - which is where this tool comes into play.

[pb33f]

An example of a complex and managed spec would be the Digital Ocean specification https://github.com/digitalocean/openapi/blob/main/specificat...