July 2021 Summaries

Reference docs 2.0 introduces a significant upgrade to API documentation with a modernized, user-friendly interface and enhanced features. The update features a more readable layout with improved fonts, tables, and spacing, as well as a refreshed "Try it" console and a centralized floating search window with browser search override. It supports OpenAPI 3.1, allowing users to leverage new features while maintaining compatibility with older versions. The platform enhances user control with layout switching buttons, expandable schemas, deep links, and sticky language selection in code samples. Documentation producers benefit from extensive theming options, custom sidebar links, and customizable code sample tabs, facilitating a more personalized and navigable experience. Compared to its open-source counterpart, Redoc, Reference docs 2.0 offers superior features, flexibility, and performance, including autogenerated code samples and enhanced search capabilities, marking it as a leading tool for API documentation.

June marked a period of significant updates and enhancements for Redocly, with contributions across various product lines and documentation. Key advancements include improved member access management for API projects, integration with Bitbucket Cloud to streamline project creation and build status tracking, and support for SSO user accounts to simplify login processes. Enhancements to Reference docs introduced a new specification extension, x-defaultClientId, and improved documentation of enum values, while the Developer portal saw upgrades in Markdown snippet support and the ability to specify image sizes. Printer-friendly portal pages and custom URL redirection after logout were also introduced. Additionally, Redoc now offers basic support for OpenAPI 3.1, and documentation improvements included revised navigation and information architecture to aid users in accessing resources efficiently. These updates reflect a concerted effort to enhance user experience and streamline workflow processes.