Best design, easy to use (github actions integration), includes a built-in changelog Review collected by and hosted on G2.com.
Not much, which is why I chose them. However, some potential ideas to improve would be to continuously improve the design, and/or expand product offerring (SDK generation). This feedback is a stretch though, because Bump does one thing and does it well - great docs! Review collected by and hosted on G2.com.
When developing a REST API your work lacks an interface, at least an interface humans are capable of handling. I mean, an JSON interface scattered around alot of urls is not something that comes natural to humans.
Leveraging an OpenAPI specification solves this gap and makes your work visible.
When Im speaking of the evolution of the OpenAPI specification I'm talking about Bump. Bump creates your documentation and is even telling you how your API is evolving over time by providing a changelog. Incorporating Bump into your CI even can block your release when it is not backwards compatible. Nobody wants unattend breaking changes in a patch release.
Communication is key and Bump helps you communicating your API changes to your collegeaus and clients in a way thats almosts costs you notting in time and money. Review collected by and hosted on G2.com.
Bump is in an early phase. In example I cannot add a clarification message to a release to point to some specific changes and tell why that change is necessary. Review collected by and hosted on G2.com.
Experience with their portal was great, few clicks with OAS file, and documentation was up. And documentation UI is very good, has modern look rather then other generators that have classic looks. Review collected by and hosted on G2.com.
Experience so far is good, haven't faced any issues yet. Review collected by and hosted on G2.com.