Archive - Scheduled Downtime

Why We Built Our Own OpenAPI to Markdoc Generator

No existing tool did what we needed, so we built our own.

Aug 4 •

David Amrani

July 2025

Stop Maintaining API Docs Manually: Our OpenAPI Generation Journey

How we built a system where tests generate docs, SDKs, and code examples from a single source of truth

Jul 21 •

David Amrani

2

1

#nojs-banner { position: fixed; bottom: 0; left: 0; padding: 16px 16px 16px 32px; width: 100%; box-sizing: border-box; background: red; color: white; font-family: -apple-system, "Segoe UI", Roboto, Helvetica, Arial, sans-serif, "Apple Color Emoji", "Segoe UI Emoji", "Segoe UI Symbol"; font-size: 13px; line-height: 13px; } #nojs-banner a { color: inherit; text-decoration: underline; } This site requires JavaScript to run correctly. Please turn on JavaScript or unblock scripts