Update on OpenAPI and JSON SchemaUpdate 2020-02-02: JSON Schema Draft 2019-09 has been published for a while, and after much deliberation we got the folks at OpenAPI to…
Reinventing API Design with Stoplight StudioTwo months ago I teased that Stoplight was about to release something big, and yesterday we announced Stoplight Studio - an OpenAPI and…
Solving OpenAPI and JSON Schema DivergenceUpdate 2020-02-02: This article has been replaced entirely, as the proposed workaround was written into a now abandoned project Speccy, and…
OpenAPI and JSON Schema Divergence: Part 1This article is going to explain the divergence between OpenAPI and JSON Schema, which I’ve been calling the subset/superset/sideset problem…
Design-first API Specification Workflow MaturesBack in October I wrote Chasing the Perfect API Specification Workflow, which was a huge article about the state of the API specification…
One Month Since OpenAPI v3.0Last month today OpenAPI v3.0 was released, and not only is there a lot of cool stuff, but it unblocks some akward situations with vendor…
Chasing the Perfect API Specification WorkflowDocumentation is a nice thing to have, but it is often treated as optional or superfluous, especially in teams where the clients and servers…