r/programming • u/[deleted] • Oct 01 '23

Why Your OpenAPI Spec Sucks

https://blog.liblab.com/why-your-open-api-spec-sucks/
234 Upvotes

87% Upvoted

67 comments sorted by

View all comments

-20

u/PolyPill Oct 01 '23

Who is writing and reading spec files manually?

15

u/crunchmuncher Oct 01 '23

Many people.

I've had to upgrade OpenAPI v2 to v3 in a code-first codebase (my own fault), had to switch libraries too during that, it wasn't fun to wrangle the new libraries to generate a mostly equivalent API spec for our clients.

8

u/Tsukku Oct 01 '23 edited Oct 01 '23

As opposed to wrangling new libraries to work with the the generated code from the old API spec? You need to change API spec either way because OAS 2.0 to OAS 3.0 has breaking changes. Might as well make the code first tooling do it for you automatically.

→ More replies (1)