rodinia
I concede that the magic there is in the standardization of API level docs, and not the special sauce that OpenAPI brings to the table. I just don't know of an alternative that is as language agnostic as OpenAPI.
Personally, I enjoy using server frameworks with first class support for OpenAPI. The projects I've used it in have forced me to write documentation first, and really think about what I'm trying to accomplish from a design perspective. I am by all metrics a very average developer, and a tool that pushes me to think in a new way is one I'd like to use.
Here's an example of the type of framework I'm talking about, this is Flask + OpenAPI. https://github.com/zalando/connexion
That said, different strokes for different folks. I am sure it is a massive headache to deal with all that YAML if you're not getting anything out of it.
Much thanks to the devs that made this possible over the years. It is a shining example of what a JavaScript tool should be like. I wish it could be given the money and time it deserves.
The same pattern at my current role has worked while migrating an AngularJS app to Vue.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Refe...