6 ms·
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 oper
by pb33f 2y ago
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 2y agoAn example of a complex and managed spec would be the Digital Ocean specification https://github.com/digitalocean/openapi/blob/main/specification/DigitalOcean-public.v2.yaml https://github.com/digitalocean/openapi/blob/main/specificat...