Developer portal changelog

1.0.0-beta.150 (2021-06-16)

Fixes

Resolved an issue with illegible content in the JsonSchema component caused by a dark background.

1.0.0-beta.149 (2021-06-15)

Features

Developer portal pages are now more printer-friendly thanks to improvements to the print CSS stylesheet.

1.0.0-beta.148 (2021-06-11)

Features

The login component in the portal header now supports redirecting to a custom URL after users log out of the portal. You can set the custom URL in the login.menu section of the siteConfig.yaml file. Refer to the login component documentation for more details.

Fixes

Resolved an issue with inconsistent dependencies that crashed the build after performing a clean install of the portal.

1.0.0-beta.147 (2021-06-07)

Fixes

Automatic exclusion of the top-level README.md file now works as intended. If your portal has this file in the root of the project, it will now be automatically excluded from the portal build and from search.

1.0.0-beta.146 (2021-05-31)

Fixes

Resolved an issue with the search functionality that prevented the search results from including all scopes.

1.0.0-beta.145 (2021-05-27)

Features

Implemented support for controlling access to portal sidebars with RBAC.

Fixes

Long headings in MD(X) page table of contents will now automatically wrap when they exceed the width of the page.

1.0.0-beta.144 (2021-05-25)

Features

The Developer portal sidebar now supports a new configuration option - selectFirstItemOnExpand - to control the behavior of group items. When this option is set to true, selecting the group name in the sidebar automatically activates the first item in the group. When using this option, you must not add the page option to the same group.

Fixes

Resolved an issue with circular references preventing the MenuItem override from importing the original MenuItem and decorating it.
Upgraded the @redocly/reference-docs library to version 1.5.5.

1.0.0-beta.143 (2021-05-20)

Features

Upgraded the @redocly/reference-docs library to version 1.5.4. Check the Reference docs changelog for details on what's new in that version.

Fixes

Resolved an issue with the login button using an invalid pathPrefix which affected the login page URL in build previews.
Inline code in MD(X) pages now wraps properly and no longer exceeds the width of the containing element.

1.0.0-beta.142 (2021-05-18)

Features

If the content on your portal is protected behind a login, you can now set up the login component without having to implement custom overrides. Define the settings for your login button and menu in the siteConfig.yaml file, then customize the user avatar in the components > login section of the theme.ts file. Note that the login component is disabled by default, and that it requires you to configure login and authentication settings for the portal.
The portal now supports a login page in local development mode, making it easier to simulate the login process for debugging purposes.
The following Apigee page components are now built into the portal and can be imported from @redocly/developer-portal/apigee:
- AppPage
- AppsPage
- CreateAppPage

Check the developer portal starter repository for an example, and refer to our Apigee integration documentation to understand how Apigee works with Redocly Developer portal.

1.0.0-beta.141 (2021-05-12)

Features

You can now integrate Google Global Site Tag into your developer portal. When configured, this integration works only in production, not in local development mode. Check our siteConfig.yaml documentation for instructions on how to set it up.
Developer portal now supports overriding the global App wrapper to set a custom global context. The override should be created as a new file _override/App.tsx, and the portal must be restarted after saving the file to apply the changes.
The usePageData helper can now return pageId (an internal portal page ID) and the page frontmatter object (if applicable).

Deprecated

The package @redocly/ui is now deprecated. From this version forward, use @redocly/developer-portal/ui instead.

1.0.0-beta.140 (2021-05-11)

Fixes

Resolved an issue with old versions of the yaml module that could happen when upgrading the portal without removing the .lock file.
Resolved an issue with builds breaking for portals that use the JsonSchema component after upgrading to the 1.0.0-beta.139 version.
Implemented the improvements from Reference docs 1.5.1.

1.0.0-beta.139 (2021-05-07)

Features

We have improved the organization of the main portal configuration file, siteConfig.yaml. All analytics integrations are now configured under the top-level analytics key. Compare the old and the new configuration syntax:

- ga:
-   trackingId: your-google-analytics-tracking-id
- googleTagManager:
-   id: your-google-tag-manager-id
-
+ analytics:
+   ga:
+     trackingId: your-google-analytics-tracking-id
+   googleTagManager:
+     id: your-google-tag-manager-id
+

Although the old configuration syntax still works, it displays warnings in the log, so we recommend switching to the new one.

You can now integrate FullStory analytics into your developer portal. When configured, this integration works only in production, not in local development mode. Set it up in your siteConfig.yaml file like in the following example:

analytics:
  fullstory:
    fs_org: YOUR_ORG_ID

Deprecated

The headerIcon option in the siteConfig.yaml configuration file has been deprecated. Use logo instead to set the path to your portal logo.

Fixes

Resolved an issue with the hideInfoSection: true not working in integrated Reference docs pages.

1.0.0-beta.138 (2021-04-29)

Features

Rich metadata images are now supported in the front matter of MD(X) pages. Add image: /path/to/image-file to the front matter of a page to set up its preview image. This image is displayed when sharing the link to the page on social media.
You can now set the contents of the <meta name="keywords"> tag in your portal. Provide the keywords as a comma-separated list, e.g. keywords: documentation, api, openapi in the meta section of the siteConfig.yaml file. You can also override the site-wide keywords and set them in the front matter of each individual MD(X) page.
At last, the developer portal theme lets you style buttons. You can change the font weight and font family of the button text, control button shadowing and hover behavior, and set the border radius for the button element. All these options should be set in the components > buttons section of your theme.ts file. Additionally, we have improved the overall default appearance of buttons in the portal, and made their font sizes and shadows more consistent.

Fixes

Resolved an issue related to Next/Back buttons when RBAC is enabled in the portal.

1.0.0-beta.137 (2021-04-29)

Broken release.

1.0.0-beta.136 (2021-04-22)

Fixes

Resolved an issue with the wrong core-js import that was crashing the tests for some of our customers.

1.0.0-beta.135 (2021-04-19)

Features

To improve the navigation in your developer portal, you can now enable the "Back to" button on MD(X) pages. To enable the button site-wide, for all pages at once, add showPrevButton: true to the siteConfig.yaml file. Alternatively, enable it only on specific pages by adding showPrevButton: true to the page front matter.
If you reference any files (such as images or Markdown pages) in the front matter of your MD(X) files, those files will now be copied to the static folder in the portal. References to those files will be automatically replaced by their destination links.

Fixes

Resolved an issue with require images caused by the upgrade to Gatsby v3.

1.0.0-beta.134 (2021-04-15)

Features

The portal can now use top-level context to pass the current API definition down to components. This allows users to import the context (as import {usePageData} from '@redocly/ui') and use it in their own custom components (as const {rawApiDefinition} = usePageData();).

Fixes

Removed the old version of the API Overview page in integrated Reference docs and implemented support for the new one.
After logout, the portal now redirects to a path with a trailing slash.
Definition IDs with dashes (e.g. api-main) now work properly with components that require definitionId, such as OpenApiExample or OpenApiRequestBody.
Resolved an issue where long group sublabels in drilldown sidebar style would overflow the sidebar width.
Resolved an issue with the portal navbar not taking the full screen width and displaying gaps on the sides.
Resolved an issue with incorrect paths for the Reference docs license key on Windows.

1.0.0-beta.133 (2021-04-15)

Broken release.

1.0.0-beta.132 (2021-04-13)

Fixes

Resolved an issue with RBAC where menu item permissions in the sidebar were lost for pages added using the /* pattern.

1.0.0-beta.131 (2021-04-13)

Features

We have migrated the Developer portal to Gatsby v3, updated all outdated dependencies, and resolved security warnings.

warning

To upgrade your portal to this version, first remove yarn.lock, then run yarn clean, followed by yarn install.

Fixes

Checkboxes for oAuth2 scopes in the clientCredentials flow are now properly rendered in the Reference docs Try it console.

1.0.0-beta.130 (2021-04-07)

Fixes

Resolved an issue with the search index not working for partial operation path fragments (e.g. in user/findById, the findById part was not searchable).
Improved the custom login functionality for multiple identity providers. This is supported only in developer portals hosted on-premise.

1.0.0-beta.129 (2021-04-06)

Fixes

Resolved an issue with the sidebar and the Try it console scrolling under the navigation bar in some cases.
Resolved an issue with auth section links pointing to an invalid URL when using the index.page.yaml file in the root of the portal.

1.0.0-beta.128 (2021-04-02)

Fixes

Resolved an issue with the Reference docs version switcher not working correctly for operations without a tag and the overview page.
OAS definitions errors are now displayed in the terminal output.
Improved page scrolling handlers to optimize performance.

1.0.0-beta.127 (2021-03-31)

Features

The rightPanel > width theming option can now accept the CSS calc function as a value.

1.0.0-beta.126 (2021-03-31)

Features

The rightPanel > width theming option now supports media query values, allowing you to customize it depending on the screen size (example: rightPanel: { width: { medium: '40%', large: '800px'}}).
The typography > links section of the Developer portal theme now lets you customize the textDecoration value.
The pageId is now passed to custom Markdown template properties.

Fixes

Pinned the version of the informed library to prevent an infinite loop when opening the Try it console in Reference docs.

1.0.0-beta.125 (2021-03-29)

Fixes

Resolved an issue with RBAC not working for portals hosted in Workflows when the auth section was omitted from the siteConfig.yaml file.

1.0.0-beta.123 (2021-03-27)

Features

You can now customize the width and padding of the main content wrapper (the area containing the text from your MD(X) pages). This is done by modifying the values in the contentWrapper section of your portal theme.ts file:

components:
  contentWrapper: {
    maxWidth: '910px',
    paddingHorizontal: '0',
    paddingVertical: '40px',
  },

Fixes

Resolved an issue with the incorrect default maxWidth value of the main content wrapper element.

1.0.0-beta.122 (2021-03-27)

Features

You can now customize the values for marginTop, marginBottom, marginLeft and marginRight in the developer portal theme.ts file for all heading levels (H1 to H6). Here is an example for H2:

heading2: {
    fontSize: '1.50em',
    fontWeight: '600',
    color: '#000000',
    capitalize: false,
    marginTop: '1.25em',
    marginBottom: '0.8em',
},

The developer portal now allows you to define the value of theming options as a breakpoints object. When configured in this way, theming options are used according to the breakpoints specified in the theme, ensuring your portal looks great at any screen size.

Here is an example excerpt from the theme.ts file showing how to define a breakpoints object for typography.fontSize:

  breakpoints: {
    small: '320px',
    medium: '720px',
    large: '1280px',
  },
  typography: {
    fontSize: { _: '36px', small: '42px', medium: '52px', large: '60px' },
    lineHeight: '1.6'
  }

In this example, the font size of 42 px is used only on small screen sizes. Values configured as strings (like lineHeight in the example) are used on all screen sizes. The special breakpoint _ cannot be manually set in the breakpoints section of the theme, but you should use it in all breakpoints objects. It defines the value for the smallest screen sizes (0 to "small"). If you don't specify it, the default theme value will be used instead.

The following theming options now support the breakpoints object as the value (in addition to previously supported string values):

typography:
    fontFamily,
    fontSize,
    lineHeight,
    code:
        fontFamily,
        fontSize
    headings:
        fontFamily,
        lineHeight
    heading1 to heading6:
        fontFamily,
        fontSize,
        lineHeight,
        marginBottom,
        marginLeft,
        marginRight,
        marginTop,
        marginHorizontal,
        marginVertical
    rightPanelHeading:
        fontFamily,
        fontSize,
        lineHeight
    fieldName:
        fontFamily,
        fontSize,
        lineHeight
schema:
    constraints:
        fontFamily,
        fontSize,
        lineHeight
    examples:
        fontFamily,
        fontSize,
        lineHeight
sidebar:
    fontFamily
codeBlock:
    tokens:
        default:
            fontFamily,
            fontSize,
            lineHeight

A new theming option showAtBreakpoint is supported in the rightPanel section of the theme.ts file. Use this option to control the starting screen size at which the right panel will become visible in Reference docs pages. Its value must be a string, and it must match one of the breakpoints defined in the theme.

Example

rightPanel: {
    backgroundColor: 'red',
    textColor: '#000000',
    showAtBreakpoint: 'medium'
    }

Fixes

301 redirects are now supported and will be functional in build previews for developer portals hosted in Redocly Workflows.
Removed the linear gradient when the bgImage property is used with the Jumbotron component.

1.0.0-beta.121 (2021-03-23)

Features

A new type of alert (or admonition) called info is now supported in Markdown files. Read more about using admonitions.
You can now customize all types of alerts directly in the developer portal theme. New theming options cover font and color changes, including the option to set custom icons for alert boxes.
Speaking of custom icons, you can now change the default icon used in the search bar (when search is enabled in your portal). Override the default icon with another one of your choice, or just modify its color. These options must be set in the developer portal theme.
Blockquotes now support additional styling options in the developer portal theme.

Fixes

Internal links are now handled client-side and no longer trigger a full page reload.
Resolved an issue with the logout helper function redirecting to a wrong location when the portal was built with --prefix-paths.
Text formatted as inline code now properly supports line breaks and will no longer overflow the page width.
Removed excessive top margin from the content wrapper.
The icons in alert boxes (also known as admonitions) are now centered in relation to the text, and their appearance has been improved to make them stand out.

1.0.0-beta.120 (2021-03-19)

Features

You can now disable Sharp-based image optimization for your developer portal by setting disableImagesOptimization: true in the siteConfig.yaml file. Sharp is now an optional dependency in the portal installation, so if it fails to install for any reason, the portal will continue to work.
Image optimization is now disabled by default in portal development mode. To enable it in your local development server:
- either add the --with-images-optimization flag to the start command in package.json,
- or run the server with yarn start --with-images-optimization.

1.0.0-beta.119 (2021-03-18)

Features

A new front matter option redirectFrom is now supported in MD(X) pages. Use this option to define a list of one or more URLs. This will create meta-refresh redirects from all listed URLs to your page when building the portal.

Fixes

Resolved several minor issues with search indexing for integrated Reference docs with pagination set to item or section.

1.0.0-beta.118 (2021-03-18)

Features

Markdown files now support simpler, more convenient syntax for admonitions (warnings, notes, tips...). You can use these admonition types: info, success, warning, danger, attention - read the documentation for more details. Here's a comparison of the old and the new syntax:

- <div class="warning"><b>Optional title</b>
-
- Some warning text
-
- </div>
+ :::warning Optional title
+
+ Some warning text
+
+ :::

Fixes

The search functionality now works for integrated Reference docs when pagination is set to item or section.

1.0.0-beta.117 (2021-03-16)

Features

New, simplified pagination options for Reference docs are now supported in the Developer portal. The behavior and settings for paginated Reference docs in the portal are now consistent with that of standalone Reference docs. Find more details on new defaults and how to adjust them in the Migration guide section.
A new configuration option hideInfoDescription is now supported in .page.yaml files for finer control over the integrated Reference docs content.

Deprecated

When integrating Reference docs into your portal, do not use the following options in .page.yaml file(s), as they are no longer supported:
- expand
- includeSections
- showInfo
When declaring the type for integrated Reference docs in .page.yaml file(s), set it as type: reference-docs. Setting it as type: redoc is no longer supported.

Migration guide

After upgrading to Developer portal 1.0.0-beta.117, you may notice some changes in your integrated Reference docs. You may also need to modify the configuration options in your .page.yaml files.

Here's a list of changes and new defaults you may want to adjust:

Build logs will show warnings for the type: redoc value in your .page.yaml file(s). Change it to type: reference-docs.
The showInfo option is no longer supported in .page.yaml files. The functionality of showInfo: true is now the default, so you can remove it from .page.yaml. To replace the functionality of showInfo: false, add hideInfoSection: true under settings.

type: reference-docs
definitionId: example
settings:
  hideInfoSection: true

By default, your integrated Reference docs now have an API overview page like the standalone Reference docs, with basic information about the API and the Download button. This page has its own menu item in the sidebar, and uses the info.title value from the API definition as the default item name. To set a custom menu item name, use the label option in the .page.yaml file. To hide the Download button on the API overview page, add hideDownloadButton: true under settings. To hide the entire API overview page and its menu item in the sidebar, add hideInfoSection: true under settings.
The expand option is no longer supported in .page.yaml files. To replace the functionality of expand: false, add pagination: none under settings in your .page.yaml file, then include that .page.yaml file in sidebars.yaml as follows:

exampleSidebar:
 - page: openapi/reference.page.yaml/*
 - page: other-example-page.md

To replace the functionality of expand: true, add either pagination: item or pagination: section under settings˙.

The includeSections option is no longer supported in .page.yaml files. To replace the functionality of includeSections: false, add hideInfoDescription: true under settings. The functionality of includeSections: true is now the default, so you can remove it from .page.yaml.
Markdown sections from your API definition info.description are now displayed by default. To hide them, add hideInfoDescription: true under settings. This does not hide the entire info section.
The authentication section is added by default to your info.description sections. To hide it, add noAutoAuth: true under settings.

In summary, consider adding these settings to hide content that's now visible by default:

settings:
  hideInfoSection: true
  hideInfoDescription: true
  hideDownloadButton: true
  noAutoAuth: true

Fixes

Implemented the set of improvements from Reference docs 1.3.19.

1.0.0-beta.116 (2021-03-11)

Features

New theming options for item spacing are now supported in the sidebar.

Fixes

The version switcher sticks to the the top of the sidebar.
Fixed group expand/collapse behavior for specific cases.
Fixed inconsistent spacing when groups and pages are at the same level.

1.0.0-beta.115 (2021-03-10)

Features

In addition to previously supported relative links (../guides/example.md), your links to MD(X) files can now be absolute (/guides/example.md) from the root of the Developer portal. This gives you more freedom when linking your content.
The version switcher element for quick navigation between multiple API documentation versions is now supported in the Developer portal. To enable it for integrated Reference docs in your portal, list the versions you want to display in the .page.yaml file(s). Read more in the reference docs integration.

1.0.0-beta.114 (2021-03-10)

1.0.0-beta.113 (2021-03-10)

Broken releases.

1.0.0-beta.112 (2021-03-04)

Features

Redocly Developer portal now sports a freshly redesigned sidebar. It's not just about the looks, either - several sidebar theming and configuration options are now available. For example, you can add a custom icon and custom description text to sidebar groups when using the drilldown sidebar style. A new type of separator - horizontal divider line - is also supported, and can be added to the sidebar as separatorLine: true. New theming options make it possible to change the sidebar background color, font family and size, separator color, and control the spacing of items. Read more on how to customize the portal sidebar in the documentation.

Updating to this version of Developer portal will automatically change the visual style of your portal sidebar, but it will not change your sidebars.yaml file contents.

To revert to the old sidebar style, you must either downgrade your Developer portal to an older version or override the sidebar. A basic override example is available in the developer portal starter repository.

Fixes

Implemented the set of UX improvements to the Try it console from Reference docs 1.3.17.

1.0.0-beta.111 (2021-03-03)

Features

The Next to navigation button visible at the bottom right of portal pages can now be hidden. You can disable it for the entire developer portal by setting showNextButton to false in the siteConfig.yaml file. Alternatively, hide it for each individual page by setting showNextButton: false in the front matter of your MD(X) files.
Canonical URLs are now supported in the developer portal. To enable this, set a value for siteUrl in the meta section of your siteConfig.yaml file (for example, siteUrl: 'https://www.example.com'). This value will be used as the base URL for canonical links, and rel="canonical" will be automatically added to the head of all HTML pages in your portal.

1.0.0-beta.110 (2021-02-24)

Features

A new helper function called usePathPrefix is now available and can be imported from @redocly/ui.
A new front matter option exclude is now supported on MD and MDX pages. Use it to exclude an entire page from the portal build by adding exclude: true to the page front matter.
The WideTile component now supports the maxWidth property. You can configure the property as a percentage or as an exact amount of pixels.

Fixes

Issues with the Reference docs configuration option showRightPanelToggle have been resolved.
Tile components now properly support mailto: links.
If your developer portal project contains a top-level README.md file, this file will now be excluded from the portal build.
When using the WideTile component that contains an icon, the icon and the content will now be aligned to the top of the tile element instead of to the center.

1.0.0-beta.109 (2021-02-16)

Features

Implemented support for multiple identity providers in the on-premise Docker container. Identity providers can be configured in the auth section of the siteConfig.yaml file.
The LoginPageLink component now supports a new property called idpId. Use it to specify one of the identity providers configured in the siteConfig.yaml file. If you're using React hooks, you can now import the custom hook useLoginPageUrl from @redocly/ui and use it with idpId like in the following example:

const loginLink = useLoginPageUrl(idpId);

Note that these changes apply only to the on-premise Docker container, not to hosted Developer portals.

Deprecated

The allowLoginWith configuration option for the on-premise Docker container is now deprecated and should not be used.

1.0.0-beta.108 (2021-02-12)

Fixes

Fixed breaking builds after yarn.lock and node_modules are deleted.
Fixed the --relative-paths argument by using path prefixes from an environment variable.
Fixed incorrect path resolution of reusable Markdown snippets.

1.0.0-beta.107 (2021-02-12)

Broken release.

1.0.0-beta.106 (2021-02-02)

Fixes

Pinned mobx dependency to prevent crashes when upgrading.

1.0.0-beta.105 (2021-01-28)

Fixes

The search index will no longer crash when page names start with _.
Resolved a cryptic JavaScript error when the portal failed to load an OpenAPI definition.
Improved real-time reloading when the sidebar state changes to expanded.

1.0.0-beta.104 (2021-01-25)

Fixes

Fixed crashing when reusable Markdown snippets are embedded in MDX.
Added a warning that snippets are not supported in MDX.
Removed bad #undefined hash in some links.

1.0.0-beta.103 (2021-01-25)

Features

Redocly now supports single-source authoring and content reuse with Markdown snippets. Create "chunks" of text, save them as Markdown files in your developer portal project, and embed them into other pages across the portal.

Fixes

Implemented support for pathPrefix in the RBAC feature.
The HTTP scheme name (e.g. Bearer) is now capitalized in code samples.

1.0.0-beta.102 (2021-01-20)

Features

Users can now override defaults to customize SearchInput and SearchResults components.

1.0.0-beta.101 (2021-01-15)

Fixes

Removed many incorrect warnings that were cluttering the console output.

1.0.0-beta.100 (2021-01-15)

Fixes

Resolved an issue with mermaid diagrams overflowing the page size.
Resolved a HTML-related nesting issue by rendering ThinTile as a div if it doesn't have the to property.
Lint problems are now ignored for registry downloads.

1.0.0-beta.99 (2021-01-14)

Features

Developer portal now supports auto-generated C# and Python code samples in embedded API reference documentation.

Fixes

Implemented support for the correct default RBAC permission.
The mobile view button for expanding the sidebar menu has been temporarily disabled because of a bug in the full non-paginated reference docs page.

1.0.0-beta.98 (2021-01-04)

Features

A new front matter configuration option is available - excludeFromSearch. When you add excludeFromSearch: true to the front matter of a Markdown page, the page will be excluded from the search index and will not be accessible from the search results.
Implemented support for matchPath in MDX pages. This functionality is required for advanced client routes and for the upcoming Apigee portal integration.

Fixes

Hash fragments (named anchors) can now be used in relative links to MD and MDX pages; for example [link](./file.md#section-id).
Previously, OAS 2 API definitions could be imported only as files from the local filesystem. Now they can be imported from URLs, and they work with registry snapshot URLs (including the Logs > Snapshots > Get Snapshot option).
Resolved a minor styling issue with the position of anchor link icons when targeting a header.

1.0.0-beta.97 (2020-12-30)

Broken release.

1.0.0-beta.96 (2020-12-17)

Features

It is now possible to customize the entire sidebar menu. Check the developer portal starter repository for an example of how to change the sidebar style.
By popular demand, links in the navigation bar can now have custom icons. To add a custom icon for an item, provide the path to the icon image as the value of the new icon field in the nav section of the siteConfig.yaml file. An example is available in the developer portal starter repository.

Fixes

Improved the look of parameters with multiple examples in Reference docs.

1.0.0-beta.95 (2020-12-15)

Fixes

Implemented support for using API reference docs as the index page of the developer portal. This can be achieved either by renaming the reference docs page to index.page.yaml or by setting path: "/" in the corresponding .page.yaml file.
Button components without a to link will now be rendered as <button> instead of as <a>.
Portal will no longer crash when the siteConfig.yaml file contains an invalid page item in nav.

1.0.0-beta.94 (2020-12-03)

Features

Sidebar items can now be customized independently of the developer portal theme. Check the developer portal starter repository for an example of how to style the sidebar items.

1.0.0-beta.93 (2020-11-26)

Features

A new CLI option --ignore-openapi-errors is now supported. When this option is used, the portal build will not fail if validation errors are found in API definition files.
Implemented a new helper React hook called useAPICatalog in @redocly/ui. It returns a list of all API definitions in the developer portal project (plus some metadata), and can be used to create API catalog pages.

1.0.0-beta.92 (2020-11-23)

Internal release without changes.

1.0.0-beta.91 (2020-11-22)

Features

Implemented support for the RBAC (Role-based access control) feature. With RBAC, you can define permissions for accessing specific parts of your developer portal, and assign those permissions to different types of users (roles). This feature is available only to Enterprise customers, and only if the developer portal is hosted on-premise using Docker.

Fixes

Fixed the style for code blocks inside headings.

1.0.0-beta.90 (2020-11-18)

Features

The siteConfig.yaml file now supports linking to external API definition files by using $ref in the oasDefinitions section.

1.0.0-beta.89 (2020-11-13)

Fixes

Resolved an issue with alert content rendering when content was passed as React children.
Minor TypeScript type fixes been implemented.

1.0.0-beta.88 (2020-11-06)

Features

The Alert UI component now supports nested content for all alert variants. Nested content is added to an alert using the children property.

Fixes

Properly applied the fix for broken code highlighting on initial page load (issue carried over from previous release).
All page links on the portal now use lowercase letters. Page links that previously contained uppercase letters will be automatically transformed to all lowercase letters (for example, ./developer-portal/Getting-Started.md becomes /developer-portal/getting-started/). As a consequence, some links may break after updating to this version of the Developer portal.
When adding pages to the portal using the /* "spread" pattern to include all files from a path, the pages will now be grouped by folder in the navigation sidebar.

1.0.0-beta.87 (2020-11-02)

Fixes

Resolved an issue with broken code highlighting on initial page load.
Implemented a performance fix in search-indexer for API definitions that use deep-nested oneOf. This change potentially resolves the RAM overflow issue reported by some customers.
Fixed the 401 error for manifest.json file when using basic authentication.

1.0.0-beta.86 (2020-10-29)

Features

Code samples in Reference docs can now be automatically generated for curl, JavaScript, and Node.js. This feature can be enabled for on-premise Developer portal deployments by editing the .page.yaml configuration file.

Fixes

Reduced the clutter in the browser log output.

1.0.0-beta.85 (2020-10-28)

Features

Upgraded to the latest version of reference-docs. This version introduces support for CORS Proxy configuration, allowing more control over requests sent from the "Try It" API console.

1.0.0-beta.84 (2020-10-21)

Features

New options for styling the portal sidebar are now available; namely: sidebar.textColor, sidebar.activeTextColor, and sidebar.activeBgColor.

Fixes

The layout of API reference docs is no longer broken on small screen sizes in Firefox. GitHub issue reference
Styled components can now be used for styling ThinTile, WideTile and Alert.
Custom queries will be properly extracted from MDX files with Windows-style line endings.
colors.<color>.contrastText can now be used for the Alert text color, where <color> is warning, success, error, or info.

1.0.0-beta.83 (2020-10-20)

Features

Allow running development server on GitHub Codespaces.
Upgrade reference-docs to v1.1.5.
Copy auth metadata to artifacts folder (for on-prem auth-server).

Fixes

Reduced clutter in the log output.

1.0.0-beta.82 (2020-09-28)

Fixes

Resolved an issue with redirecting to the developer portal home page after the user logs out.
Exported the setSecurityDetails helper.

1.0.0-beta.81 (2020-09-15)

Fixes

Fix requireLogin infinite reloading.

1.0.0-beta.80 (2020-09-15)

Fixes

Fix some utility functions that were not exported.

1.0.0-beta.79 (2020-09-15)

Features

Export helpers for anonymous login.

Fixes

Fix JsonSchema style issue.

1.0.0-beta.78 (2020-09-11)

Features

Add new side menu style: drilldown.

1.0.0-beta.77 (2020-09-11)

Features

Add new OpenAPI-powered components: OpenApiRequestBody, OpenApiExample, JsonSchema.

Bug fixes

Fix non-expanded reference docs broken build.

Deprecations

Renamed APIResponse to OpenApiResponse.

1.0.0-beta.76 (2020-09-03)

Features

Use remote rendering for mermaid diagrams.
Support for IdP issued tokens for Redocly Workflows OIDC integration.

1.0.0-beta.75 (2020-09-03)

Broken release.

1.0.0-beta.74 (2020-08-26)

Bug fixes

Fixed badge label for webhooks (with x-webhooks usage).

1.0.0-beta.73 (2020-08-25)

Features

Upgrade to the latest Redocly reference-docs:
- x-webhooks support
- accessibility features

Bug fixes

Fixed broken pages with spread /*.

1.0.0-beta.72 (2020-08-17)

Bug fixes

Proper error message for missing pages with spread /* instead of crash.

Features

Export some auth helpers: useProxiedFetch, getUserJwt, getUserId.

1.0.0-beta.71 (2020-07-28)

Bug fixes

Fixed WideTile icon margins.

1.0.0-beta.70 (2020-07-28)

Bug fixes

Adjusted default style of Tiles.

1.0.0-beta.69 (2020-07-28)

Features

Add new style properties to ThinTile and WideTile.
Add colors.navbar.gradient toggle to the theme.ts.

Support code snippet title

Example usage

Syntax:

```js JavaScript Example
console.log('Hello, JS');
```

```python Python Example
print('Hello, python');
```

Result:

JavaScript ExamplePython Example

console.log('Hello, JS');

print('Hello, python');

Upgrade mermaid to ^8.6.0 (support auto-wrapping and newlines).
Add option tocMaxDepth to limit the number of nested levels (globally in siteConfig.yaml or in front matter).
Add option disableLastModified to hide last modified label (globally in siteConfig.yaml or in front matter).

Bug fixes

Fix local css loading on Windows.
Fix inconsistent box shadow for thin tile.
Fix site meta image.
Support relative paths starting with ./ in sidebar.yaml.
Support external: true to show external site icon for sidebar menu items.
Fix "Next to" button for groups with page.