Documenting APIs That Actually Help Developers
ThoughtWorks Radar called out Swagger this quarter, and it lined up with what we were doing.
We’d written great APIs, but devs still struggled using them — because our docs were scattered and outdated.
Swagger (now OpenAPI) changed that:
- Docs as code
- Live testing via Swagger UI
- Clear contracts for consumers
Swagger UI
APIs should be usable without a meeting. Swagger made that possible.
This post is licensed under CC BY 4.0 by the author.
