September 2021 updates

By Swapnil Ogale

September was a super busy month at Redocly, given the exciting amount of features we have been baking into our products. We are talking about API discovery, file uploads, portal customizations, and more.

There are also some really cool things we are working on in the background, and we can't wait to share them, but that will have to wait until end of October.

For now though, let's have a quick look at our product updates, enhancements and documentation-related news from September 2021.


Workflows

Improvements to the API registry page

The API registry page is now more efficient, usable and easier to navigate, which allows you to discover your APIs and other assets faster.

  • Use the Search feature to look up API versions by name.
  • If you have labels assigned to your API versions, you can now filter by labels quickly.
  • We've added two options for sorting your API versions: Sort alphabetically or by newest first.
  • The API registry page is also now properly paginated to neatly organize your APIs and unclutter the interface.

For more information, read our Discovering APIs topic.

New default role for authenticated users

We added a new default role called authenticated-user for authenticated users. If you use RBAC (role-based access control) and do not have any roles associated with your identity provider (IdP), you can now add this default role to the frontmatter to protect your API documentation.

Workflows changelog

Find out about other fixes and enhancements by visiting the Workflows changelog.

Workflow features


Reference docs

Upload files using the Try it console

The Try It console now lets you upload files to send in your requests. If the requestBody schema has valid type and format properties, the Choose file button is visible in the request body section of the Try It console. This is applicable to:

Support for Ruby code samples

Reference docs can now automatically generate Ruby code samples. To configure this, refer to the configure auto-generated code samples topic.

Auto synchronization of examples and content type selection

  • If you use custom names for examples to map request and response examples in your API definitions, these examples now automatically synchronize with each other when selected in Reference pages.
  • Content type selection in Reference docs now automatically synchronizes between request and response schemas in the middle panel and the response and request examples in the right panel.

Reference docs changelog

Here's a link to the entire Reference docs changelog.

Reference docs features


Developer portal

Reminder: In August 2021, we released Developer portal (v1.1) which included support for Reference docs 2.0 and brought a complete visual overhaul to your integrated API reference docs.

info

This version (v1.1) of the Developer portal is now synchronized with all the changes described in the Reference docs changelog.

For the full list of changes and upgrade instructions, refer to the migration guide.

Copy code blocks with one click

Markdown code blocks now have a handy Copy button, so you can copy the entire code block with one click! This feature is global (affects all pages in the portal) and it's enabled by default in the 1.1.0-beta.55 version.

To find out more, refer to the Code snippets configuration topic.

Set the default expansion behavior for schemas

You can now use the schemaExpansionLevel property in Portal components to set the default expansion behavior for schemas.

  • To expand the whole schema contents, set it to all.
  • If you set it to a specific number, schemas will be expanded only up to that level. For example, schemaExpansionLevel: 3 will automatically expand schema contents up to three levels.

Support for customized sitemap

We implemented support for customizing the sitemap record for specific pages in the portal. This functionality is provided by the gatsby-plugin-sitemap plugin.

Support for two new React components

You can now use two new React components in your portals: OpenApiCodeSample and OpenApiTryIt.

For more information, refer to the OpenApiCodeSample and OpenApiTryIt topics.

Simpler TOC configuration options

We have now simplified and consolidated the table of contents (ToC) configuration options. Instead of adding multiple separate top-level items to your siteConfig.yaml file, you can now control all ToC-related options in one place.

Reorganized logo configuration

Similar to the ToC configuration, we have simplified the logo configuration. Your portal logo image can now open any custom URL when clicked, so it's no longer just decorative, but useful too!

For more information, refer to the logo configuration topic.

Added API key status information

Customers who use our Apigee integration will notice the App page has been fully redesigned, and now includes more detailed information on the API key status.

Developer portal changelog

Read the entire list of fixes and enhancements on the Developer portal changelog.

Developer portal features


OpenAPI CLI and Redoc

OpenAPI CLI changelog

Read more about OpenAPI CLI fixes and enhancements by visiting the OpenAPI CLI changelog.

OpenAPI CLI features


Documentation updates

The technical writing team has been busy adding new content and updating existing content to ensure we are constantly adding new content, and filling in the gaps between our product features and docs.

  • Added new topics for:

  • We tweaked our docs site navigation and information architecture to closely mirror our product interface, making it easier to search for relevant topics.

    • Docs are now grouped by API registry, Reference, Portals, People, Teams, Settings, Open source products, and an Education section for learning about OpenAPI.
    • Within these groups, we have used sub-grouping (where possible) Guides, Configuration, Settings, and Resources to keep the content experience consistent.
    • Added landing pages for sub-group headings to give a quick overview of what each section contains. For example, here's the API registry guides page.

Google Season of Docs - Update

Along with our core technical writing team, our Google Season of Docs technical writers have also been contributing to our open source product documentation actively.

In the last month, we:


Redocly at apidays Australia

Our Technical Writer Advocate presented a talk on The secret sauce to successful APIs at the apidays Australia on Sept 15th.

Video from the talk is now available on the apidays Youtube channel.