openapi

Spec-driven development: the OpenAPI file is the source of truth

Code structure & architectureOct 27, 20265 min

When I start a new service, I do not write the HTTP handlers by hand. I describe the API in an OpenAPI file first, and the handlers are generated from it. The compiler then will not let the spec and the code drift apart: you change the spec, run one command, and the build stays broken until the handlers match. I would not build a JSON API any other way now, and the reason is the mess it replaced.

Read the post