March 2026 Summaries

Arazzo is a standard designed to describe API workflows, managed by the OpenAPI Initiative, complementing OpenAPI by detailing how to chain API calls to achieve business objectives, such as booking travel arrangements. Although the first version of the Arazzo specification was published in 2024 and is gaining traction among API vendors, it is anticipated that most Arazzo files will be generated rather than manually written. A new step-by-step Arazzo guide has been released, enhancing the initial January cheat sheet, thanks to Phil Sturgeon's efforts following his work on the OpenAPI guide. While the guide is open to feedback for improvements, it is shared under a CC BY-NC-SA 4.0 license, encouraging widespread use and collaboration, especially by those heavily involved in API workflow development, like Bump.sh.

Redpanda, a company focused on creating a next-generation data streaming platform, sought to enhance their API documentation system to improve developer experiences and streamline operations. Their previous API documentation tools, Redoc and Rapidoc, posed challenges such as manual customization burdens, fragmented documentation, and lack of automated change management. To address these issues, Redpanda partnered with Bump.sh, which offered a comprehensive feature set along with process improvements like overlays for fine-grained spec editing and automated changelog capabilities. The partnership allowed Redpanda to reduce API documentation work resolution time by 60%, freeing up engineering resources to focus on product development. Bump.sh also provided a smooth onboarding experience with consistent communication and support, leading to immediate enhancements in documentation processes and reader experience. This collaboration not only improved productivity but also positioned Redpanda to confidently expand their APIs without compromising quality, highlighting Bump.sh as both a tactical and strategic partner in their growth.