Documenting APIs That Actually Help Developers
Documenting APIs That Actually Help Developers

Documenting APIs That Actually Help Developers

Author
Shiv Bade
Tags
swagger
api-first
developer experience
documentation
Published
October 27, 2014
Featured
Slug
Tweet
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
Swagger UI
APIs should be usable without a meeting. Swagger made that possible.