3 ms·
I'm a heavy OAS 2.0 user, but I'm terrified to upgrade because existing tools barely work with 2.0. Not many are available for 3.0. Even official codegen is mos
by smt88 8y ago
I'm a heavy OAS 2.0 user, but I'm terrified to upgrade because existing tools barely work with 2.0. Not many are available for 3.0. Even official codegen is mostly broken, in my experience.
I haven't yet found a single tool that correctly, fully supports the spec (except Swagger Editor). Many don't even support references! The most egregious is possibly the AWS API Gateway implementation, which is just false advertising, really.
- nsievers 8y agoI know the team is working hard to get codegen updated to support 3.0 within the next couple of months. It's a slow process moving over to 3.0, but people are doing it. In our experience, we see a lot of individuals converting to 3.0 when they currently aren't defining their APIs with Swagger 2.0 but are now looking to standardize on OAS. Swagger Inspector helps most with this process. SwaggerHub has an easy 2.0 to 3.0 converter for APIs already defined in 2.0.
- orliesaurus 8y agoDid you try Spotlight.io's tool? They're local to Austin, TX (where I live) and seem to work heavily on this.
- smt88 8y agoI've used it extensively, and their implementation is also pretty buggy, especially related to example data. It's much better than most though, I agree.
- chatmasta 8y agoFYI for anyone who hadn't heard of this tool, the parent made a typo -- it should be stoplight.io
- orliesaurus 8y agoYes, you're right - it's an unmemorable startup name and I admit I made a typo