Mmastodon TechnologySoftware first seen 10 h ago, last 10 h ago, peak #5
Developers push back on Swagger UI as default API docs
Original: "Our docs are Swagger UI" is a sentence that makes API consumers sigh in 2026. Swagger UI is a... # api # documentation
A long-running complaint is circulating among software developers: teams that simply point API consumers at a default Swagger UI installation instead of building proper documentation. Commenters argue that in 2026 this reads as a sign of low effort, since modern tooling can generate attractive, readable docs directly from OpenAPI specifications. The discussion covers how to build better documentation from the same OpenAPI files, and it is resonating with developers who regularly consume third-party APIs.
Why now: Developers are debating the gap between auto-generated Swagger UI pages and the polished API documentation now expected of professional projects.
Evidence
- "Our docs are Swagger UI" is a sentence that makes API consumers sigh in 2026. Swagger UI is a... # api # documentation # webdev # opensource # software # coding # development # engineering # inclusive # community How to build beautiful, modern API documentation from OpenAPI in… · hackaday@www.urbanmind.net · 2
API: https://socialmediatrends-api.osmike.com/v1/trends/886184