swagger codegen "does Ruby". Is that an answer?
@seachanged Might be. I know it's not too hard to generate individual snippets in whatever language. Guess it's going to boil down to the usual of looking at how it's been done and emulating that.
@seachanged Yes! I'm very early with this so thought it would be good to chat about. Was just returning to an idea a couple days ago and was like... I'm sure there's a better way than a readme doc to do APIs and found OAS. In my last job people used Postman a lot so this has been fun playing with Insomniac and developing the yaml spec.
@weex
You're right, it is a better way.
You still might need the readme, because there are a lot of API semantics that cannot be expressed in the OpenAPI schema, but the nesting and naming can telegraph a lot of information that cannot be expressed in the syntax; and the description fields should be well used.
There is also a degree of pure expression in creating the OpenAPI spec that takes me to the quiet place where things get done, and I like that very much.