Bump Reviews

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.

Experience so far is good, haven't faced any issues yet.

Generating and deployment of documentation right from OAS file.

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.

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.

Communication REST API changes to your stakeholders in an automated way.