Re:Show HN: REST Alternative to GraphQL and tRPC
by CharlieDigital on Tuesday October 10, 2023 @04:15PM
(#37836885)
OpenAPI itself doesn't need to be human readable because it's readily translated into human readable form using tools like Redocly, RapiDoc, or any other host of tools that create output documents from input OpenAPI spec.
Openapi is not human readable IMO and the point is you design the API waaaay before you write any line of code. The api should express the business needs and be a two way discussion with the frontend people.