jmarkdavis
5 years agoOccasional Visitor
SwaggerHub editor irritants
I just started with SwaggerHub and the online IDE. I'm not new to API design, just to this toolset. I hate to start out with a complaint, but this editor is really, really aggravating. Here are a few issues:
- Bouncing in and out of Swagger 2 and OpenAPI 3 when trying to save or save to a new version, leaving a trail of zombified versions behind
- Defaulting to Swagger 2
- Automatically sticking "oas3" on the end of version numbers, which some non-SmartBear tools hate
- Requiring editor and file upgrades and transformations to oas 3
- Switching the openapi tag to a swagger tag and refusing to transform on save
- Clicking the Save combo box (on purpose or by accident) and it opens a pulldown that cannot be closed
I like what you guys are doing, but this stuff ought not to be.