August 2024 Summaries

API governance is essential for a modern API strategy, emphasizing the pillars of consistency, quality, and security to enhance an organization's API practices. Effective governance requires intentional alignment and investment from technical leaders to ensure long-term success, addressing key areas like common language, tooling, and standards. Successful API governance is often associated with strong DevOps practices, fostering an environment where APIs can continuously evolve and meet business needs. Security is bolstered through tools like linting to ensure compliance with organizational standards, and internal adoption is critical, necessitating time, skill, and knowledge investment. Building a strong API culture involves training and integrating expertise into the existing landscape, recognizing APIs as products that require proper resourcing and prioritization. Cultivating expertise within teams is vital, as is ongoing support and training through resources like books, online learning, and industry events. A sustainable API governance approach focuses on value creation, understanding that effective practices are often subtle yet impactful, similar to an accompanist's role.

A new suite of products has been introduced, featuring Redoc for API reference rendering and mock servers, Revel for external showcase capabilities, Reef as an internal service catalog, and Realm as an integrated combination of these tools. Reunite is highlighted as a collaborative tool for preparing and deploying projects with Git integration. The update includes a focus on user feedback, improved API documentation UX, visual review capabilities, and enhanced SSO and RBAC features. Noteworthy improvements include Replay for API testing, a Scorecard for API readiness, and a preference for Markdoc over MDX for content management. The suite aims to streamline workflows with features like catalog and scorecard generation, support for GraphQL and AsyncAPI, and improved search functionalities. The emphasis on dogfooding has allowed for significant feature enhancements, encouraging users to engage with the products and explore their capabilities through early access and free trials.

Reunite is a newly developed system designed to enhance the flexibility and capabilities of project management and configuration, addressing the limitations of previous systems like Workflows and the Developer portal beta. It integrates with identity providers for SSO, Git providers, and incorporates user feedback, offering features such as visual reviews and a Git-integrated online editor. The new system also distinguishes between "API registry" and "Remote content," allowing for more automated and configurable onboarding of APIs and other content types. Reunite supports roles and access management with free viewer seats, while contributors incur charges, and introduces three main unbundled products: Redoc for API documentation, Revel for external docs, and Reef for internal portals, all of which can be combined into a discounted package called Realm. The migration to Reunite involves connecting project repositories, setting up identity providers, and preparing content adjustments to ensure a seamless transition.

Redocly underwent a significant transformation to address limitations in its existing system, primarily driven by the need for increased flexibility to accommodate new technologies and evolving customer demands. This initiative was spearheaded by CTO Roman Hotsiy, who, despite initial skepticism from the team, developed a new core engine dubbed "New Hope." The journey was fraught with challenges, including external pressures like the war in Ukraine and difficulties in team expansion. With guidance from an advisor, Redocly recognized the broader potential of its tools beyond documentation, envisioning them as central to engineering teams and fostering collaboration between developers and non-developers. Focusing on customer feedback, especially from industries such as banking and travel, highlighted the need for improved onboarding and documentation. Committed to returning to a self-service model akin to GitHub, Redocly set a launch date aligned with its anniversary, unveiling new products—Redoc, Revel, Reef, and Reunite—collectively known as Realm, marking the start of a new era for the company.