Topic
Offset pagination is easy until data changes under the client; cursors are stable but opaque and bad for jump-to-page. Here is how to choose, how to document each style in OpenAPI 3.2, and the response envelope that stops frontend teams guessing.
Read articleA 4,000-line YAML file is unmaintainable, but splitting a spec wrong creates a web of relative refs that no editor or bundler can resolve. Here is a folder layout that scales past 200 operations, the $ref conventions that keep it sane, and the CI checks that keep it honest.
Read articleAutomatic converters handle the mechanical 80 percent and quietly break the other 20: nullable fields, consumes/produces, body parameters, security definitions, and examples. Here is the migration checklist that actually gets a 2.0 spec to 3.2 without lying to consumers.
Read articleStoplight Studio's desktop editor is no longer maintained, and teams are re-evaluating what an OpenAPI editor should be: a visual form, a YAML IDE, or a workspace where the spec also drives mocks, tests, and MCP. Five options compared on real work.
Read article