if you’re willing to wait a few weeks, my company is releasing an open-source framework for OpenAPI that takes a document-centric view (it uses the OpenAPI schema as a central source of truth and there are no additional DSLs to learn).

We just pushed it to a private repo for one release worth of validating in prod before fully open sourcing it.

Note that this is not exactly what you are working for, it’s more like how Go and C# developers do it… But I’m convinced that going from the schema to code is the “correct way” of doing things, instead of going from code (comments, annotations, etc) to schema.

So I kept trying to contact my former boss but he said nothing, so I’ll have to rewrite it. There will be some news on this front soon.

Just to follow up on this thread, Apical has now been published on hex.pm