@@ -73,6 +73,18 @@ paths:
7373 minLength : 1
7474` ` `
7575
76+ This layering is not an OpenAPI quirk. When [Kin
77+ Lane](https://apievangelist.com) inventoried every API specification stewarded
78+ by the Linux Foundation, he found that [JSON Schema is the connective tissue
79+ of the entire
80+ catalogue](https://apievangelist.com/2026/06/30/the-linux-foundation-is-the-home-of-our-api-specifications/):
81+
82+ > The deeper I looked, the more one thread kept showing up underneath
83+ > everything else: JSON Schema. OpenAPI uses it. Arazzo and Overlay use it.
84+ > AsyncAPI uses it. CloudEvents ships a JSON Schema. OSV and SPDX lean on it.
85+ > The OpenAPI metaschema is JSON Schema. [...] JSON Schema is the substrate
86+ > the other specifications are built on top of.
87+
7688## Let's measure how big the engine is
7789
7890We analysed 4,127 real-world API specifications from the
@@ -196,5 +208,11 @@ API-first registry, a governance model, a discovery mechanism, and tooling
196208that understands them as semantic objects rather than as opaque sections
197209within a YAML file.
198210
211+ Kin Lane [arrives at the same
212+ conclusion](https://apievangelist.com/2026/06/30/the-linux-foundation-is-the-home-of-our-api-specifications/)
213+ from the standards side: *"there is no reason a CloudEvent's schema, an
214+ AsyncAPI message, and an OpenAPI body could not lean on the same JSON Schema
215+ tooling and the same registry patterns"*.
216+
199217The data says the schema layer is already most of your API. The question is
200218whether you treat it that way.
0 commit comments