OpenAPI

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.