draw.io vs. SwaggerHub

draw.io can be more suitable for technical documentation for architectures, flow diagrams/charts, and conceptual images of an application infrastructure. However, this tool is not made for business intelligence work nor for dashboarding to monitor the technical components. From the administrative standpoint, this is not well suited for agile ceremony structures like retrospective boards or planning or even quarterly planning boards. The strength of draw.io lies strongly in being a lightweight diagramming tool.

Incentivized

ReadyAPI and SwaggerHub are a match made in heaven. Being able to so easily import the API directly into ReadyAPI and then being able to generate a test suite from the API is my favorite part of these softwares. We have rather large services so building out the API can take some time

Incentivized

• Draw.io offers a lot of shapes and customizability of how the diagrams are laid out. We've been able to create a lot of different things with it, and have barely scratched the surface of the sorts of things that we could do.
• Draw.io is fairly intuitive in the way that you draw shapes and connect shapes together, I was able to figure it out without a tutorial.
• Draw.io is fast and performant for me compared with some of the alternatives.

Incentivized

• Treating the design as documentation ensures that we have consistent and well defined APIs
• API consumers can export the swagger definition or code stubs to use within their development environment
• We can iterate through multiple versions of a definition privately before making a version publicly available

Incentivized

• When very elaborate diagrams are needed, it lacks the amount of tools and customization needed
• Since this is an online tool, it can freeze and that causes you to lose that work up to that point
• Performance can lag with very complex diagrams

Incentivized

• The user interface could be more improved to sustain with other similar tools in the market.
• Beneficial if we have better integration with third party softwares.
• Nice to have ability to download the documentation in usable formats.

Incentivized

The UI is intuitive. It allows a new user to start diagramming almost instantly. Manipulating elements, linking them together, etc. are all easy to do. Draw.io nevertheless a broad variety of diagram templates to help get started and also of shapes to use in diagrams. Some situations can make it a bit tricky to use, such as when having multiple shapes on top of each other (e.g. shapes placed within swimlanes) but that's a minor issue.

Incentivized

The support for draw.io is pretty decent, considering it is a free website. I had a question one time when I was trying to do something, so I sent an email to their support email and got a response fairly quickly with an answer to my question. They also have some excellent support tools on their support website for helping you get more familiar with their program, and I found that very helpful.

Incentivized

draw.io is open-source and free for many uses, which means minimal upfront cost and good value.It works in the browser, also has a desktop version (so you can use offline) which helps teams that may not always be online or want local backups. Useful when you want a diagram tool that “just works” without huge ecosystem lock-in.For organisations that value control, less vendor-dependency, this is a plus.

Incentivized

The only other product we looked at was Postman. But we liked the SwaggerHub UI & the integrations it has with the AWS API gateway. Though Postman has some other great features like the ability to write test cases & execute them, SwaggerUI was more convenient to document & share them.

Incentivized

• draw.io has surely impacted our organization positively by saving some crucial time.
• It has not really impacted much monetarily to be honest.
• The ROI we got from draw.io is that it has made complex things clear for everyone in our organization.

Incentivized

• Faster API development lifecycle.
• Reduced discussion time when building a new vital API endpoint.
• Complete documentation which makes the new team member onboarding process easier.

Incentivized