Every time I try to use an OpenAPI document to generate client code, it fails, I talk to the customer and they say "oh no don't do that, it's not meant for generating code from". Not an indictment on OpenAPI but it's truly bizarre how people use it.
I’m working with a spec that used GUIDs for their operation IDs. This limits TypeScript code generation to typescript-node, which prepends an underscore on the method names. Otherwise, those starting with numbers would be invalid.