I've found OpenAPI to be fine to work with until you start trying to do really silly things with query parameters or multipart bodies, etc.

I can understand why OpenAPI has those issues though - it is because OpenAPI is aiming to DOCUMENT APIs rather than SPECIFY them. That is a hard task given how wide a set of things you can do with HTTP.

So be charitable when comparing OpenAPI to XYZ API specification tool.