From 78c7e37ecb3ac511dfbd46bc02be67f0a7cadc2b Mon Sep 17 00:00:00 2001
From: Ivan Shvets <37488015+Leocete@users.noreply.github.com>
Date: Fri, 2 Jul 2021 18:14:26 +0300
Subject: [PATCH 01/43] chore: changed docs sync flow

---
 .github/workflows/sync.yml | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/.github/workflows/sync.yml b/.github/workflows/sync.yml
index 6ff78faa..ba673bd0 100644
--- a/.github/workflows/sync.yml
+++ b/.github/workflows/sync.yml
@@ -14,3 +14,5 @@ jobs:
         uses: Redocly/repo-file-sync-action@master
         with:
           GH_PAT: ${{ secrets.GH_PAT }}
+          COMMIT_PREFIX: "sync:"
+          SKIP_PR: true

From a7a1efd83fc4d2a896641d0f0e9703301e4a09c0 Mon Sep 17 00:00:00 2001
From: Roman <marshevskyy@gmail.com>
Date: Mon, 5 Jul 2021 15:50:43 +0300
Subject: [PATCH 02/43] chore: added security section into pull request
 template

---
 .github/pull_request_template.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 .github/pull_request_template.md

diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
new file mode 100644
index 00000000..7de82936
--- /dev/null
+++ b/.github/pull_request_template.md
@@ -0,0 +1,18 @@
+## What/Why/How?
+
+## Reference
+
+## Testing
+
+## Screenshots (optional)
+
+## Check yourself
+
+- [ ] Code is linted
+- [ ] Tested
+- [ ] All new/updated code is covered with tests
+
+## Security
+
+- [ ] Security impact of change has been considered
+- [ ] Code follows company security practices and guidelines

From eba55124c970eab3da606bc12c2ce6f7ee2fea1a Mon Sep 17 00:00:00 2001
From: Waldir Pimenta <waldyrious@gmail.com>
Date: Fri, 9 Jul 2021 08:25:52 +0100
Subject: [PATCH 03/43] docs: improve the redoc cli README (#1679)

- Break some long lines
- Add some articles (the, a)
- Add a couple links for additional context
- Expand the SSR acronym
- Describe what --watch does
---
 cli/README.md | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/cli/README.md b/cli/README.md
index 32bb0e0e..bc6d8bcf 100644
--- a/cli/README.md
+++ b/cli/README.md
@@ -3,20 +3,29 @@
 **[ReDoc](https://github.com/Redocly/redoc)'s Command Line Interface**
 
 ## Installation
-You can use redoc cli by installing `redoc-cli` globally or using [npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b).
+
+You can use `redoc-cli` by installing [the package](https://www.npmjs.com/package/redoc-cli) globally,
+or using [npx](https://medium.com/@maybekatz/introducing-npx-an-npm-package-runner-55f7d4bd282b).
 
 ## Usage
 
-Two following commands are available:
+The two following commands are available:
 
-- `redoc-cli serve [spec]` - starts the server with `spec` rendered with ReDoc. Supports SSR mode (`--ssr`) and can watch the spec (`--watch`)
-- `redoc-cli bundle [spec]` - bundles spec and ReDoc into **zero-dependency** HTML file.
+- `redoc-cli serve [spec]` - starts the server with `spec` rendered with ReDoc.
+  Supports a server-side rendering mode (`--ssr`),
+  and can watch the spec (`--watch`) to automatically reload the page whenever it changes.
+- `redoc-cli bundle [spec]` - bundles `spec` and ReDoc into a **zero-dependency** HTML file.
 
 Some examples:
 
-- Bundle with main color changed to `orange`: <br> `$ redoc-cli bundle [spec] --options.theme.colors.primary.main=orange`
-- Serve with `nativeScrollbars` option set to true: <br> `$ redoc-cli serve [spec] --options.nativeScrollbars`
-- Bundle using custom template (check [default template](https://github.com/Redocly/redoc/blob/master/cli/template.hbs) for reference): <br> `$ redoc-cli bundle [spec] -t custom.hbs`
-- Bundle using custom template and add custom `templateOptions`: <br> `$ redoc-cli bundle [spec] -t custom.hbs --templateOptions.metaDescription "Page meta description"`
+- Bundle with the main color changed to `orange`:<br/>
+  `$ redoc-cli bundle [spec] --options.theme.colors.primary.main=orange`
+- Serve with the `nativeScrollbars` option set to true:<br/>
+  `$ redoc-cli serve [spec] --options.nativeScrollbars`
+- Bundle using a custom [Handlebars](https://handlebarsjs.com/) template
+  (check the [default template](https://github.com/Redocly/redoc/blob/master/cli/template.hbs) for an example):<br/>
+  `$ redoc-cli bundle [spec] -t custom.hbs`
+- Bundle using a custom template and add custom `templateOptions`:<br/>
+  `$ redoc-cli bundle [spec] -t custom.hbs --templateOptions.metaDescription "Page meta description"`
 
-For more details run `redoc-cli --help`.
+For more details, run `redoc-cli --help`.

From ec50858ec47af08c5fe553266fe3c209fba97eae Mon Sep 17 00:00:00 2001
From: ILya Volchenkov <zvolkzrus@gmail.com>
Date: Fri, 9 Jul 2021 10:33:36 +0300
Subject: [PATCH 04/43] feat: added localization for some labels (#1675)

---
 src/components/ApiInfo/ApiInfo.tsx                 |  5 +++--
 src/components/RequestSamples/RequestSamples.tsx   |  3 ++-
 src/components/ResponseSamples/ResponseSamples.tsx |  3 ++-
 src/components/Responses/ResponsesList.tsx         |  3 ++-
 src/services/Labels.ts                             | 12 ++++++++++++
 5 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/src/components/ApiInfo/ApiInfo.tsx b/src/components/ApiInfo/ApiInfo.tsx
index ae4b4b20..6debaf7e 100644
--- a/src/components/ApiInfo/ApiInfo.tsx
+++ b/src/components/ApiInfo/ApiInfo.tsx
@@ -14,6 +14,7 @@ import {
   InfoSpanBox,
   InfoSpanBoxWrap,
 } from './styled.elements';
+import { l } from '../../services/Labels';
 
 export interface ApiInfoProps {
   store: AppStore;
@@ -79,14 +80,14 @@ export class ApiInfo extends React.Component<ApiInfoProps> {
             </ApiHeader>
             {!hideDownloadButton && (
               <p>
-                Download OpenAPI specification:
+                {l('downloadSpecification')}:
                 <DownloadButton
                   download={downloadFilename || true}
                   target="_blank"
                   href={downloadLink}
                   onClick={this.handleDownloadClick}
                 >
-                  Download
+                  {l('download')}
                 </DownloadButton>
               </p>
             )}
diff --git a/src/components/RequestSamples/RequestSamples.tsx b/src/components/RequestSamples/RequestSamples.tsx
index 89b12d74..7a06d89f 100644
--- a/src/components/RequestSamples/RequestSamples.tsx
+++ b/src/components/RequestSamples/RequestSamples.tsx
@@ -6,6 +6,7 @@ import { SourceCodeWithCopy } from '../SourceCode/SourceCode';
 
 import { RightPanelHeader, Tab, TabList, TabPanel, Tabs } from '../../common-elements';
 import { OptionsContext } from '../OptionsProvider';
+import { l } from '../../services/Labels';
 
 export interface RequestSamplesProps {
   operation: OperationModel;
@@ -26,7 +27,7 @@ export class RequestSamples extends React.Component<RequestSamplesProps> {
     return (
       (hasSamples && (
         <div>
-          <RightPanelHeader> Request samples </RightPanelHeader>
+          <RightPanelHeader> {l('requestSamples')} </RightPanelHeader>
 
           <Tabs defaultIndex={0}>
             <TabList hidden={hideTabList}>
diff --git a/src/components/ResponseSamples/ResponseSamples.tsx b/src/components/ResponseSamples/ResponseSamples.tsx
index 3f9eefa0..72384fe5 100644
--- a/src/components/ResponseSamples/ResponseSamples.tsx
+++ b/src/components/ResponseSamples/ResponseSamples.tsx
@@ -5,6 +5,7 @@ import { OperationModel } from '../../services/models';
 
 import { RightPanelHeader, Tab, TabList, TabPanel, Tabs } from '../../common-elements';
 import { PayloadSamples } from '../PayloadSamples/PayloadSamples';
+import { l } from '../../services/Labels';
 
 export interface ResponseSamplesProps {
   operation: OperationModel;
@@ -23,7 +24,7 @@ export class ResponseSamples extends React.Component<ResponseSamplesProps> {
     return (
       (responses.length > 0 && (
         <div>
-          <RightPanelHeader> Response samples </RightPanelHeader>
+          <RightPanelHeader> {l('responseSamples')} </RightPanelHeader>
 
           <Tabs defaultIndex={0}>
             <TabList>
diff --git a/src/components/Responses/ResponsesList.tsx b/src/components/Responses/ResponsesList.tsx
index 157aca58..e578a1cf 100644
--- a/src/components/Responses/ResponsesList.tsx
+++ b/src/components/Responses/ResponsesList.tsx
@@ -1,4 +1,5 @@
 import * as React from 'react';
+import { l } from '../../services/Labels';
 import { ResponseModel } from '../../services/models';
 import styled from '../../styled-components';
 import { ResponseView } from './Response';
@@ -26,7 +27,7 @@ export class ResponsesList extends React.PureComponent<ResponseListProps> {
 
     return (
       <div>
-        <ResponsesHeader>{isCallback ? 'Callback responses' : 'Responses'}</ResponsesHeader>
+        <ResponsesHeader>{isCallback ? l('callbackResponses') : l('responses')}</ResponsesHeader>
         {responses.map(response => {
           return <ResponseView key={response.code} response={response} />;
         })}
diff --git a/src/services/Labels.ts b/src/services/Labels.ts
index 8e89bc2f..71b83e58 100644
--- a/src/services/Labels.ts
+++ b/src/services/Labels.ts
@@ -10,6 +10,12 @@ export interface LabelsConfig {
   arrayOf: string;
   webhook: string;
   const: string;
+  download: string;
+  downloadSpecification: string;
+  responses: string;
+  callbackResponses: string;
+  requestSamples: string;
+  responseSamples: string;
 }
 
 export type LabelsConfigRaw = Partial<LabelsConfig>;
@@ -26,6 +32,12 @@ const labels: LabelsConfig = {
   arrayOf: 'Array of ',
   webhook: 'Event',
   const: 'Value',
+  download: 'Download',
+  downloadSpecification: 'Download OpenAPI specification',
+  responses: 'Responses',
+  callbackResponses: 'Callback responses',
+  requestSamples: 'Request samples',
+  responseSamples: 'Response samples',
 };
 
 export function setRedocLabels(_labels?: LabelsConfigRaw) {

From d72444008533623c87f238fe8758b1dd518b89eb Mon Sep 17 00:00:00 2001
From: Roman Hotsiy <gotsijroman@gmail.com>
Date: Fri, 9 Jul 2021 17:04:53 +0300
Subject: [PATCH 05/43] feat: add yaml highlight (#1684)

* feat: add yaml highlight

* chore: upgrade prism version
---
 package-lock.json      | 14 +++++++-------
 package.json           |  2 +-
 src/utils/highlight.ts |  1 +
 3 files changed, 9 insertions(+), 8 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 5601ef16..79a0831f 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -26,7 +26,7 @@
         "path-browserify": "^1.0.1",
         "perfect-scrollbar": "^1.5.1",
         "polished": "^4.1.3",
-        "prismjs": "^1.24.0",
+        "prismjs": "^1.24.1",
         "prop-types": "^15.7.2",
         "react-tabs": "^3.2.2",
         "slugify": "~1.4.7",
@@ -15962,9 +15962,9 @@
       }
     },
     "node_modules/prismjs": {
-      "version": "1.24.0",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.0.tgz",
-      "integrity": "sha512-SqV5GRsNqnzCL8k5dfAjCNhUrF3pR0A9lTDSCUZeh/LIshheXJEaP0hwLz2t4XHivd2J/v2HR+gRnigzeKe3cQ=="
+      "version": "1.24.1",
+      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.1.tgz",
+      "integrity": "sha512-mNPsedLuk90RVJioIky8ANZEwYm5w9LcvCXrxHlwf4fNVSn8jEipMybMkWUyyF0JhnC+C4VcOVSBuHRKs1L5Ow=="
     },
     "node_modules/process": {
       "version": "0.11.10",
@@ -33230,9 +33230,9 @@
       }
     },
     "prismjs": {
-      "version": "1.24.0",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.0.tgz",
-      "integrity": "sha512-SqV5GRsNqnzCL8k5dfAjCNhUrF3pR0A9lTDSCUZeh/LIshheXJEaP0hwLz2t4XHivd2J/v2HR+gRnigzeKe3cQ=="
+      "version": "1.24.1",
+      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.1.tgz",
+      "integrity": "sha512-mNPsedLuk90RVJioIky8ANZEwYm5w9LcvCXrxHlwf4fNVSn8jEipMybMkWUyyF0JhnC+C4VcOVSBuHRKs1L5Ow=="
     },
     "process": {
       "version": "0.11.10",
diff --git a/package.json b/package.json
index 6f85f321..ead71f3e 100644
--- a/package.json
+++ b/package.json
@@ -163,7 +163,7 @@
     "path-browserify": "^1.0.1",
     "perfect-scrollbar": "^1.5.1",
     "polished": "^4.1.3",
-    "prismjs": "^1.24.0",
+    "prismjs": "^1.24.1",
     "prop-types": "^15.7.2",
     "react-tabs": "^3.2.2",
     "slugify": "~1.4.7",
diff --git a/src/utils/highlight.ts b/src/utils/highlight.ts
index d86ee374..036b9129 100644
--- a/src/utils/highlight.ts
+++ b/src/utils/highlight.ts
@@ -19,6 +19,7 @@ import 'prismjs/components/prism-ruby.js';
 import 'prismjs/components/prism-scala.js';
 import 'prismjs/components/prism-sql.js';
 import 'prismjs/components/prism-swift.js';
+import 'prismjs/components/prism-yaml.js';
 
 const DEFAULT_LANG = 'clike';
 

From e3b2f10ab0cbdf1c66091030f96da6ee94dc0d22 Mon Sep 17 00:00:00 2001
From: Andrea Mugx <andrea.mugnaini@fundingcircle.com>
Date: Fri, 9 Jul 2021 15:59:30 +0100
Subject: [PATCH 06/43] chore(cli): v0.12.2

---
 cli/package.json | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/cli/package.json b/cli/package.json
index cb55452e..862d795e 100644
--- a/cli/package.json
+++ b/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "redoc-cli",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "description": "ReDoc's Command Line Interface",
   "main": "index.js",
   "bin": "index.js",
@@ -19,7 +19,7 @@
     "node-libs-browser": "^2.2.1",
     "react": "^17.0.1",
     "react-dom": "^17.0.1",
-    "redoc": "2.0.0-rc.54",
+    "redoc": "2.0.0-rc.55",
     "styled-components": "^5.3.0",
     "yargs": "^17.0.1"
   },

From 43470f17e377a3891d85c8b9a64dcb1689e5625f Mon Sep 17 00:00:00 2001
From: Andrea Mugx <andrea.mugnaini@fundingcircle.com>
Date: Fri, 16 Jul 2021 07:18:44 +0100
Subject: [PATCH 07/43] chore: bumps npm-shrinkwrap (#1688)

---
 cli/npm-shrinkwrap.json | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/cli/npm-shrinkwrap.json b/cli/npm-shrinkwrap.json
index 4df4fbaf..b18bd6f6 100644
--- a/cli/npm-shrinkwrap.json
+++ b/cli/npm-shrinkwrap.json
@@ -1,6 +1,6 @@
 {
   "name": "redoc-cli",
-  "version": "0.12.1",
+  "version": "0.12.2",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {

From 8dc00a9f1c5ac0236e5f187ca7e6056617976989 Mon Sep 17 00:00:00 2001
From: romanhotsiy <gotsijroman@gmail.com>
Date: Fri, 16 Jul 2021 09:23:32 +0300
Subject: [PATCH 08/43] chore: upgrade shrinkwrap

---
 cli/npm-shrinkwrap.json | 114 ++++++----------------------------------
 1 file changed, 16 insertions(+), 98 deletions(-)

diff --git a/cli/npm-shrinkwrap.json b/cli/npm-shrinkwrap.json
index b18bd6f6..0986cec5 100644
--- a/cli/npm-shrinkwrap.json
+++ b/cli/npm-shrinkwrap.json
@@ -6,7 +6,7 @@
   "packages": {
     "": {
       "name": "redoc-cli",
-      "version": "0.12.1",
+      "version": "0.12.2",
       "license": "MIT",
       "dependencies": {
         "chokidar": "^3.5.1",
@@ -17,7 +17,7 @@
         "node-libs-browser": "^2.2.1",
         "react": "^17.0.1",
         "react-dom": "^17.0.1",
-        "redoc": "2.0.0-rc.54",
+        "redoc": "2.0.0-rc.55",
         "styled-components": "^5.3.0",
         "yargs": "^17.0.1"
       },
@@ -605,17 +605,6 @@
       "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.3.1.tgz",
       "integrity": "sha512-OlQdbZ7gLfGarSqxesMesDa5uz7KFbID8Kpq/SxIoNGDqY8lSYs0D+hhtBXhcdB3rcbXArFr7vlHheLk1voeNA=="
     },
-    "node_modules/clipboard": {
-      "version": "2.0.8",
-      "resolved": "https://registry.npmjs.org/clipboard/-/clipboard-2.0.8.tgz",
-      "integrity": "sha512-Y6WO0unAIQp5bLmk1zdThRhgJt/x3ks6f30s3oE3H1mgIEU33XyQjEf8gsf6DxC7NPX8Y1SsNWjUjL/ywLnnbQ==",
-      "optional": true,
-      "dependencies": {
-        "good-listener": "^1.2.2",
-        "select": "^1.1.2",
-        "tiny-emitter": "^2.0.0"
-      }
-    },
     "node_modules/cliui": {
       "version": "7.0.4",
       "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
@@ -782,12 +771,6 @@
       "resolved": "https://registry.npmjs.org/decko/-/decko-1.2.0.tgz",
       "integrity": "sha1-/UPHNelnuAEzBohKVvvmZZlraBc="
     },
-    "node_modules/delegate": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/delegate/-/delegate-3.2.0.tgz",
-      "integrity": "sha512-IofjkYBZaZivn0V8nnsMJGBr4jVLxHDheKSW88PyxS5QC4Vo9ZbZVvhzlSxY87fVq3STR6r+4cGepyHkcWOQSw==",
-      "optional": true
-    },
     "node_modules/des.js": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.1.tgz",
@@ -976,15 +959,6 @@
         "node": ">=4"
       }
     },
-    "node_modules/good-listener": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/good-listener/-/good-listener-1.2.2.tgz",
-      "integrity": "sha1-1TswzfkxPf+33JoNR3CWqm0UXFA=",
-      "optional": true,
-      "dependencies": {
-        "delegate": "^3.1.2"
-      }
-    },
     "node_modules/handlebars": {
       "version": "4.7.7",
       "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.7.tgz",
@@ -1602,12 +1576,9 @@
       "integrity": "sha512-97DXOFbQJhk71ne5/Mt6cOu6yxsSfM0QGQyl0L25Gca4yGWEGJaig7l7gbCX623VqTBNGLRLaVUCnNkcedlRSQ=="
     },
     "node_modules/prismjs": {
-      "version": "1.23.0",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.23.0.tgz",
-      "integrity": "sha512-c29LVsqOaLbBHuIbsTxaKENh1N2EQBOHaWv7gkHN4dgRbxSREqDnDbtFJYdpPauS4YCplMSNCABQ6Eeor69bAA==",
-      "optionalDependencies": {
-        "clipboard": "^2.0.0"
-      }
+      "version": "1.24.1",
+      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.1.tgz",
+      "integrity": "sha512-mNPsedLuk90RVJioIky8ANZEwYm5w9LcvCXrxHlwf4fNVSn8jEipMybMkWUyyF0JhnC+C4VcOVSBuHRKs1L5Ow=="
     },
     "node_modules/process": {
       "version": "0.11.10",
@@ -1780,9 +1751,9 @@
       }
     },
     "node_modules/redoc": {
-      "version": "2.0.0-rc.54",
-      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.54.tgz",
-      "integrity": "sha512-xwukaWdoktkDAoQuhajekdC54+/lSLwIUqJCNSTVEjeYEuZPq2tFUj9H5SBt8/YSq5UF/zOmDQrXPWMgildQpQ==",
+      "version": "2.0.0-rc.55",
+      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.55.tgz",
+      "integrity": "sha512-32sUHhc33m8zQKz2V7xREwlf05S52dDOkn7K0WMquu2GDl6ZquxmrQfqnlj0IPoVCWQPR+XosmmIJj4rZbqjeA==",
       "dependencies": {
         "@babel/runtime": "^7.14.0",
         "@redocly/openapi-core": "^1.0.0-beta.50",
@@ -1802,7 +1773,7 @@
         "path-browserify": "^1.0.1",
         "perfect-scrollbar": "^1.5.1",
         "polished": "^4.1.3",
-        "prismjs": "^1.23.0",
+        "prismjs": "^1.24.0",
         "prop-types": "^15.7.2",
         "react-tabs": "^3.2.2",
         "slugify": "~1.4.7",
@@ -1890,12 +1861,6 @@
         "object-assign": "^4.1.1"
       }
     },
-    "node_modules/select": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/select/-/select-1.1.2.tgz",
-      "integrity": "sha1-DnNQrN7ICxEIUoeG7B1EGNEbOW0=",
-      "optional": true
-    },
     "node_modules/setimmediate": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
@@ -2122,12 +2087,6 @@
         "node": ">=0.6.0"
       }
     },
-    "node_modules/tiny-emitter": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/tiny-emitter/-/tiny-emitter-2.1.0.tgz",
-      "integrity": "sha512-NB6Dk1A9xgQPMoGqC5CVXn123gWyte215ONT5Pp5a0yt4nlEoO1ZWeCwpncaekPHXO60i47ihFnZPiRPjRMq4Q==",
-      "optional": true
-    },
     "node_modules/to-arraybuffer": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/to-arraybuffer/-/to-arraybuffer-1.0.1.tgz",
@@ -2853,17 +2812,6 @@
       "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.3.1.tgz",
       "integrity": "sha512-OlQdbZ7gLfGarSqxesMesDa5uz7KFbID8Kpq/SxIoNGDqY8lSYs0D+hhtBXhcdB3rcbXArFr7vlHheLk1voeNA=="
     },
-    "clipboard": {
-      "version": "2.0.8",
-      "resolved": "https://registry.npmjs.org/clipboard/-/clipboard-2.0.8.tgz",
-      "integrity": "sha512-Y6WO0unAIQp5bLmk1zdThRhgJt/x3ks6f30s3oE3H1mgIEU33XyQjEf8gsf6DxC7NPX8Y1SsNWjUjL/ywLnnbQ==",
-      "optional": true,
-      "requires": {
-        "good-listener": "^1.2.2",
-        "select": "^1.1.2",
-        "tiny-emitter": "^2.0.0"
-      }
-    },
     "cliui": {
       "version": "7.0.4",
       "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz",
@@ -3010,12 +2958,6 @@
       "resolved": "https://registry.npmjs.org/decko/-/decko-1.2.0.tgz",
       "integrity": "sha1-/UPHNelnuAEzBohKVvvmZZlraBc="
     },
-    "delegate": {
-      "version": "3.2.0",
-      "resolved": "https://registry.npmjs.org/delegate/-/delegate-3.2.0.tgz",
-      "integrity": "sha512-IofjkYBZaZivn0V8nnsMJGBr4jVLxHDheKSW88PyxS5QC4Vo9ZbZVvhzlSxY87fVq3STR6r+4cGepyHkcWOQSw==",
-      "optional": true
-    },
     "des.js": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.1.tgz",
@@ -3169,15 +3111,6 @@
       "resolved": "https://registry.npmjs.org/globals/-/globals-11.12.0.tgz",
       "integrity": "sha512-WOBp/EEGUiIsJSp7wcv/y6MO+lV9UoncWqxuFfm8eBwzWNgyfBd6Gz+IeKQ9jCmyhoH99g15M3T+QaVHFjizVA=="
     },
-    "good-listener": {
-      "version": "1.2.2",
-      "resolved": "https://registry.npmjs.org/good-listener/-/good-listener-1.2.2.tgz",
-      "integrity": "sha1-1TswzfkxPf+33JoNR3CWqm0UXFA=",
-      "optional": true,
-      "requires": {
-        "delegate": "^3.1.2"
-      }
-    },
     "handlebars": {
       "version": "4.7.7",
       "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.7.tgz",
@@ -3648,12 +3581,9 @@
       "integrity": "sha512-97DXOFbQJhk71ne5/Mt6cOu6yxsSfM0QGQyl0L25Gca4yGWEGJaig7l7gbCX623VqTBNGLRLaVUCnNkcedlRSQ=="
     },
     "prismjs": {
-      "version": "1.23.0",
-      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.23.0.tgz",
-      "integrity": "sha512-c29LVsqOaLbBHuIbsTxaKENh1N2EQBOHaWv7gkHN4dgRbxSREqDnDbtFJYdpPauS4YCplMSNCABQ6Eeor69bAA==",
-      "requires": {
-        "clipboard": "^2.0.0"
-      }
+      "version": "1.24.1",
+      "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.24.1.tgz",
+      "integrity": "sha512-mNPsedLuk90RVJioIky8ANZEwYm5w9LcvCXrxHlwf4fNVSn8jEipMybMkWUyyF0JhnC+C4VcOVSBuHRKs1L5Ow=="
     },
     "process": {
       "version": "0.11.10",
@@ -3811,9 +3741,9 @@
       }
     },
     "redoc": {
-      "version": "2.0.0-rc.54",
-      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.54.tgz",
-      "integrity": "sha512-xwukaWdoktkDAoQuhajekdC54+/lSLwIUqJCNSTVEjeYEuZPq2tFUj9H5SBt8/YSq5UF/zOmDQrXPWMgildQpQ==",
+      "version": "2.0.0-rc.55",
+      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.55.tgz",
+      "integrity": "sha512-32sUHhc33m8zQKz2V7xREwlf05S52dDOkn7K0WMquu2GDl6ZquxmrQfqnlj0IPoVCWQPR+XosmmIJj4rZbqjeA==",
       "requires": {
         "@babel/runtime": "^7.14.0",
         "@redocly/openapi-core": "^1.0.0-beta.50",
@@ -3833,7 +3763,7 @@
         "path-browserify": "^1.0.1",
         "perfect-scrollbar": "^1.5.1",
         "polished": "^4.1.3",
-        "prismjs": "^1.23.0",
+        "prismjs": "^1.24.0",
         "prop-types": "^15.7.2",
         "react-tabs": "^3.2.2",
         "slugify": "~1.4.7",
@@ -3892,12 +3822,6 @@
         "object-assign": "^4.1.1"
       }
     },
-    "select": {
-      "version": "1.1.2",
-      "resolved": "https://registry.npmjs.org/select/-/select-1.1.2.tgz",
-      "integrity": "sha1-DnNQrN7ICxEIUoeG7B1EGNEbOW0=",
-      "optional": true
-    },
     "setimmediate": {
       "version": "1.0.5",
       "resolved": "https://registry.npmjs.org/setimmediate/-/setimmediate-1.0.5.tgz",
@@ -4083,12 +4007,6 @@
         "setimmediate": "^1.0.4"
       }
     },
-    "tiny-emitter": {
-      "version": "2.1.0",
-      "resolved": "https://registry.npmjs.org/tiny-emitter/-/tiny-emitter-2.1.0.tgz",
-      "integrity": "sha512-NB6Dk1A9xgQPMoGqC5CVXn123gWyte215ONT5Pp5a0yt4nlEoO1ZWeCwpncaekPHXO60i47ihFnZPiRPjRMq4Q==",
-      "optional": true
-    },
     "to-arraybuffer": {
       "version": "1.0.1",
       "resolved": "https://registry.npmjs.org/to-arraybuffer/-/to-arraybuffer-1.0.1.tgz",

From f7211ceb0829334b3b4661d9c6168403f2345ba4 Mon Sep 17 00:00:00 2001
From: romanhotsiy <gotsijroman@gmail.com>
Date: Tue, 20 Jul 2021 15:18:21 +0300
Subject: [PATCH 09/43] chore: fix dockerfile

---
 config/docker/Dockerfile | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/config/docker/Dockerfile b/config/docker/Dockerfile
index fc7481f4..94e1762d 100644
--- a/config/docker/Dockerfile
+++ b/config/docker/Dockerfile
@@ -16,7 +16,8 @@ RUN npm ci --no-optional --ignore-scripts
 
 # copy only required for the build files
 COPY src /build/src
-COPY webpack.config.ts tsconfig.json custom.d.ts /build/
+COPY webpack.config.ts tsconfig.json custom.d.ts  /build/
+COPY config/webpack-utils.ts /build/config/
 COPY typings/styled-patch.d.ts /build/typings/styled-patch.d.ts
 
 RUN npm run bundle:standalone

From 9e1ea703e56a71567b13d0d22e2d69945a22de4d Mon Sep 17 00:00:00 2001
From: Valdir Mendes <valdir.mfjesus@hotmail.com>
Date: Fri, 30 Jul 2021 05:18:13 -0300
Subject: [PATCH 10/43] fix: handle empty object in security array (#1678)

---
 .../SecurityRequirement.tsx                   | 34 +++++++++++--------
 .../__tests__/SecurityRequirement.test.tsx    | 27 +++++++++++++++
 2 files changed, 46 insertions(+), 15 deletions(-)
 create mode 100644 src/components/__tests__/SecurityRequirement.test.tsx

diff --git a/src/components/SecurityRequirement/SecurityRequirement.tsx b/src/components/SecurityRequirement/SecurityRequirement.tsx
index 3a52ad81..91bf9f43 100644
--- a/src/components/SecurityRequirement/SecurityRequirement.tsx
+++ b/src/components/SecurityRequirement/SecurityRequirement.tsx
@@ -8,8 +8,8 @@ import { SecurityRequirementModel } from '../../services/models/SecurityRequirem
 import { linksCss } from '../Markdown/styled.elements';
 
 const ScopeName = styled.code`
-  font-size: ${props => props.theme.typography.code.fontSize};
-  font-family: ${props => props.theme.typography.code.fontFamily};
+  font-size: ${(props) => props.theme.typography.code.fontSize};
+  font-family: ${(props) => props.theme.typography.code.fontFamily};
   border: 1px solid ${({ theme }) => theme.colors.border.dark};
   margin: 0 3px;
   padding: 0.2em;
@@ -67,18 +67,22 @@ export class SecurityRequirement extends React.PureComponent<SecurityRequirement
     const security = this.props.security;
     return (
       <SecurityRequirementOrWrap>
-        {security.schemes.map(scheme => {
-          return (
-            <SecurityRequirementAndWrap key={scheme.id}>
-              <Link to={scheme.sectionId}>{scheme.id}</Link>
-              {scheme.scopes.length > 0 && ' ('}
-              {scheme.scopes.map(scope => (
-                <ScopeName key={scope}>{scope}</ScopeName>
-              ))}
-              {scheme.scopes.length > 0 && ') '}
-            </SecurityRequirementAndWrap>
-          );
-        })}
+        {security.schemes.length ? (
+          security.schemes.map((scheme) => {
+            return (
+              <SecurityRequirementAndWrap key={scheme.id}>
+                <Link to={scheme.sectionId}>{scheme.id}</Link>
+                {scheme.scopes.length > 0 && ' ('}
+                {scheme.scopes.map((scope) => (
+                  <ScopeName key={scope}>{scope}</ScopeName>
+                ))}
+                {scheme.scopes.length > 0 && ') '}
+              </SecurityRequirementAndWrap>
+            );
+          })
+        ) : (
+          <SecurityRequirementAndWrap>None</SecurityRequirementAndWrap>
+        )}
       </SecurityRequirementOrWrap>
     );
   }
@@ -89,7 +93,7 @@ const AuthHeaderColumn = styled.div`
 `;
 
 const SecuritiesColumn = styled.div`
-  width: ${props => props.theme.schema.defaultDetailsWidth};
+  width: ${(props) => props.theme.schema.defaultDetailsWidth};
   ${media.lessThan('small')`
     margin-top: 10px;
   `}
diff --git a/src/components/__tests__/SecurityRequirement.test.tsx b/src/components/__tests__/SecurityRequirement.test.tsx
new file mode 100644
index 00000000..723c0505
--- /dev/null
+++ b/src/components/__tests__/SecurityRequirement.test.tsx
@@ -0,0 +1,27 @@
+import * as React from 'react';
+import { shallow } from 'enzyme';
+
+import { OpenAPIParser } from '../../services';
+import { SecurityRequirementModel } from '../../services/models/SecurityRequirement';
+import { SecurityRequirement } from '../SecurityRequirement/SecurityRequirement';
+import { RedocNormalizedOptions } from '../../services/RedocNormalizedOptions';
+
+const options = new RedocNormalizedOptions({});
+describe('Components', () => {
+  describe('SecurityRequirement', () => {
+    describe('SecurityRequirement', () => {
+      it('should render \'None\' when empty object in security open api', () => {
+        const parser = new OpenAPIParser({ openapi: '3.0', info: { title: 'test', version: '0' }, paths: {} },
+          undefined,
+          options,
+        );
+        const securityRequirement = new SecurityRequirementModel({}, parser);
+        const securityElement = shallow(
+          <SecurityRequirement key={1} security={securityRequirement} />
+        ).getElement();
+        expect(securityElement.props.children.type.target).toEqual('span');
+        expect(securityElement.props.children.props.children).toEqual('None');
+      });
+    });
+  });
+});

From 836c4222624770faca937e3264dbe454e681a100 Mon Sep 17 00:00:00 2001
From: Marius Butuc <marius.butuc@gmail.com>
Date: Fri, 30 Jul 2021 11:19:41 +0300
Subject: [PATCH 11/43] docs: add real-life usage example: BoxKnight (#1651)

---
 README.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/README.md b/README.md
index e5db33c1..6c63e3e6 100644
--- a/README.md
+++ b/README.md
@@ -72,6 +72,7 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
 - [Commbox](https://www.commbox.io/api/)
 - [APIs.guru](https://apis.guru/api-doc/)
 - [FastAPI](https://github.com/tiangolo/fastapi)
+- [BoxKnight](https://www.docs.boxknight.com/)
 
 ## Deployment
 

From e2dee0f7416059ddda5ab33899b6cb8f067d485a Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Fri, 30 Jul 2021 17:35:52 +0300
Subject: [PATCH 12/43] chore: add github template (#1708)

---
 .github/ISSUE_TEMPLATE/bug_report.md      | 13 +++++++++++++
 .github/ISSUE_TEMPLATE/feature_request.md | 11 +++++++++++
 .github/pull_request_template.md          |  5 -----
 3 files changed, 24 insertions(+), 5 deletions(-)
 create mode 100644 .github/ISSUE_TEMPLATE/bug_report.md
 create mode 100644 .github/ISSUE_TEMPLATE/feature_request.md

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
new file mode 100644
index 00000000..4fa757c4
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -0,0 +1,13 @@
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Minimal reproducible OpenAPI snippet(if possible)**
+
+**Screenshots**
+If applicable, add screenshots to help explain your problem.
+
+**Additional context**
+Add any other context about the problem here.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
new file mode 100644
index 00000000..1212cd5c
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -0,0 +1,11 @@
+**Describe the problem to be solved**
+A clear and concise description of what problem to be solved
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.
\ No newline at end of file
diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md
index 7de82936..4933c4f3 100644
--- a/.github/pull_request_template.md
+++ b/.github/pull_request_template.md
@@ -11,8 +11,3 @@
 - [ ] Code is linted
 - [ ] Tested
 - [ ] All new/updated code is covered with tests
-
-## Security
-
-- [ ] Security impact of change has been considered
-- [ ] Code follows company security practices and guidelines

From 7eec319195df08a0fcb50d026a6d972a1069d048 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Fri, 30 Jul 2021 19:03:51 +0300
Subject: [PATCH 13/43] chore: add headers to github templates (#1710)

---
 .github/ISSUE_TEMPLATE/bug_report.md      | 9 +++++++++
 .github/ISSUE_TEMPLATE/feature_request.md | 9 +++++++++
 2 files changed, 18 insertions(+)

diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 4fa757c4..14c63f2f 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,3 +1,12 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: 'type: bug'
+assignees: ''
+
+---
+
 **Describe the bug**
 A clear and concise description of what the bug is.
 
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index 1212cd5c..041bdc52 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,3 +1,12 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+title: ''
+labels: ''
+assignees: ''
+
+---
+
 **Describe the problem to be solved**
 A clear and concise description of what problem to be solved
 

From cd2d6f76e87c8385786a9c8e51c0d11c79d9707c Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Tue, 3 Aug 2021 13:36:06 +0300
Subject: [PATCH 14/43] fix: improve openapi 3.1 (#1700)

---
 demo/openapi-3-1.yaml                          |  5 +++++
 src/components/Fields/FieldDetails.tsx         | 18 ++++++++++++++++--
 src/components/Schema/ArraySchema.tsx          | 13 +++++++++++--
 .../DiscriminatorDropdown.test.tsx.snap        |  4 ++++
 src/services/models/Schema.ts                  | 10 ++++++++--
 src/types/open-api.ts                          |  2 ++
 .../loadAndBundleSpec.test.ts.snap             |  6 ++++++
 src/utils/openapi.ts                           |  2 ++
 8 files changed, 54 insertions(+), 6 deletions(-)

diff --git a/demo/openapi-3-1.yaml b/demo/openapi-3-1.yaml
index c905d4d8..31063d4b 100644
--- a/demo/openapi-3-1.yaml
+++ b/demo/openapi-3-1.yaml
@@ -1166,6 +1166,11 @@ components:
           description: User status
           type: integer
           format: int32
+        image:
+          description: User image
+          type: string
+          contentEncoding: base64
+          contentMediaType: image/png
       xml:
         name: User
   requestBodies:
diff --git a/src/components/Fields/FieldDetails.tsx b/src/components/Fields/FieldDetails.tsx
index 9ac6cea2..1aad8c61 100644
--- a/src/components/Fields/FieldDetails.tsx
+++ b/src/components/Fields/FieldDetails.tsx
@@ -59,7 +59,7 @@ export class FieldDetails extends React.PureComponent<FieldProps, { patternShown
       } else {
         const label = l('example') + ':';
         const raw = !!field.in;
-        renderedExamples = <FieldDetail label={label} value={getSerializedValue(field, field.example)} raw={raw}  />;
+        renderedExamples = <FieldDetail label={label} value={getSerializedValue(field, field.example)} raw={raw} />;
       }
     }
 
@@ -76,6 +76,20 @@ export class FieldDetails extends React.PureComponent<FieldProps, { patternShown
               &gt;{' '}
             </TypeFormat>
           )}
+          {schema.contentEncoding && (
+            <TypeFormat>
+              {' '}&lt;
+              {schema.contentEncoding}
+              &gt;{' '}
+            </TypeFormat>
+          )}
+          {schema.contentMediaType && (
+            <TypeFormat>
+              {' '}&lt;
+              {schema.contentMediaType}
+              &gt;{' '}
+            </TypeFormat>
+          )}
           {schema.title && !hideSchemaTitles && <TypeTitle> ({schema.title}) </TypeTitle>}
           <ConstraintsView constraints={schema.constraints} />
           {schema.pattern && !hideSchemaPattern && (
@@ -110,7 +124,7 @@ export class FieldDetails extends React.PureComponent<FieldProps, { patternShown
           <ExternalDocumentation externalDocs={schema.externalDocs} compact={true} />
         )}
         {(renderDiscriminatorSwitch && renderDiscriminatorSwitch(this.props)) || null}
-        {field.const && (<FieldDetail label={l('const') + ':'} value={field.const}/>) || null}
+        {field.const && (<FieldDetail label={l('const') + ':'} value={field.const} />) || null}
       </div>
     );
   }
diff --git a/src/components/Schema/ArraySchema.tsx b/src/components/Schema/ArraySchema.tsx
index 48e7dc41..eab37595 100644
--- a/src/components/Schema/ArraySchema.tsx
+++ b/src/components/Schema/ArraySchema.tsx
@@ -4,7 +4,8 @@ import { Schema, SchemaProps } from './Schema';
 
 import { ArrayClosingLabel, ArrayOpenningLabel } from '../../common-elements';
 import styled from '../../styled-components';
-import {humanizeConstraints} from "../../utils";
+import { humanizeConstraints } from '../../utils';
+import { TypeName } from '../../common-elements/fields';
 
 const PaddedSchema = styled.div`
   padding-left: ${({ theme }) => theme.spacing.unit * 2}px;
@@ -13,12 +14,20 @@ const PaddedSchema = styled.div`
 export class ArraySchema extends React.PureComponent<SchemaProps> {
   render() {
     const itemsSchema = this.props.schema.items!;
+    const schema = this.props.schema;
+
     const itemConstraintSchema = (
       min: number | undefined = undefined,
       max: number | undefined = undefined,
     ) => ({ type: 'array', minItems: min, maxItems: max });
 
-    const minMaxItems = humanizeConstraints(itemConstraintSchema(itemsSchema.schema.minItems, itemsSchema.schema.maxItems));
+    const minMaxItems = humanizeConstraints(itemConstraintSchema(itemsSchema?.schema?.minItems, itemsSchema?.schema?.maxItems));
+
+    if (schema.displayType && !itemsSchema && !minMaxItems.length) {
+      return (<div>
+        <TypeName>{schema.displayType}</TypeName>
+      </div>);
+    }
 
     return (
       <div>
diff --git a/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap b/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap
index f293088f..fe5617ed 100644
--- a/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap
+++ b/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap
@@ -20,6 +20,8 @@ exports[`Components SchemaView discriminator should correctly render discriminat
             "activeOneOf": 0,
             "const": "",
             "constraints": Array [],
+            "contentEncoding": undefined,
+            "contentMediaType": undefined,
             "default": undefined,
             "deprecated": false,
             "description": "",
@@ -71,6 +73,8 @@ exports[`Components SchemaView discriminator should correctly render discriminat
             "activeOneOf": 0,
             "const": "",
             "constraints": Array [],
+            "contentEncoding": undefined,
+            "contentMediaType": undefined,
             "default": undefined,
             "deprecated": false,
             "description": "",
diff --git a/src/services/models/Schema.ts b/src/services/models/Schema.ts
index adb2de19..e5b36ae1 100644
--- a/src/services/models/Schema.ts
+++ b/src/services/models/Schema.ts
@@ -61,6 +61,8 @@ export class SchemaModel {
   schema: MergedOpenAPISchema;
   extensions?: Record<string, any>;
   const: any;
+  contentEncoding?: string;
+  contentMediaType?: string;
 
   /**
    * @param isChild if schema discriminator Child
@@ -120,10 +122,14 @@ export class SchemaModel {
     this.readOnly = !!schema.readOnly;
     this.writeOnly = !!schema.writeOnly;
     this.const = schema.const || '';
+    this.contentEncoding = schema.contentEncoding;
+    this.contentMediaType = schema.contentMediaType;
 
-    if (!!schema.nullable) {
-      if (Array.isArray(this.type) && !this.type.includes('null')) {
+    if (!!schema.nullable || schema['x-nullable']) {
+      if (Array.isArray(this.type) && !this.type.some((value) => value === null || value === 'null')) {
         this.type = [...this.type, 'null'];
+      } else if (!Array.isArray(this.type) && (this.type !== null || this.type !== 'null')) {
+        this.type = [this.type, 'null'];
       }
     }
 
diff --git a/src/types/open-api.ts b/src/types/open-api.ts
index d55e44b1..03898457 100644
--- a/src/types/open-api.ts
+++ b/src/types/open-api.ts
@@ -147,6 +147,8 @@ export interface OpenAPISchema {
   enum?: any[];
   example?: any;
   const?: string;
+  contentEncoding?: string;
+  contentMediaType?: string;
 }
 
 export interface OpenAPIDiscriminator {
diff --git a/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap b/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap
index 1aa507f9..7807e39e 100644
--- a/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap
+++ b/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap
@@ -2187,6 +2187,12 @@ Object {
           "id": Object {
             "$ref": "#/components/schemas/Id",
           },
+          "image": Object {
+            "contentEncoding": "base64",
+            "contentMediaType": "image/png",
+            "description": "User image",
+            "type": "string",
+          },
           "lastName": Object {
             "description": "User last name",
             "example": "Smith",
diff --git a/src/utils/openapi.ts b/src/utils/openapi.ts
index c31e3cd2..ad267722 100644
--- a/src/utils/openapi.ts
+++ b/src/utils/openapi.ts
@@ -83,6 +83,8 @@ const schemaKeywordTypes = {
   maxLength: 'string',
   minLength: 'string',
   pattern: 'string',
+  contentEncoding: 'string',
+  contentMediaType: 'string',
 
   items: 'array',
   maxItems: 'array',

From 6a52a16d5b75a2955da7217c4a264f0fa8e98c89 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Tue, 3 Aug 2021 13:37:01 +0300
Subject: [PATCH 15/43] fix: hideLoading options in redoc standalone (#1709)

---
 src/components/RedocStandalone.tsx     | 4 ++--
 src/services/RedocNormalizedOptions.ts | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/src/components/RedocStandalone.tsx b/src/components/RedocStandalone.tsx
index a4c2837c..40bf73cb 100644
--- a/src/components/RedocStandalone.tsx
+++ b/src/components/RedocStandalone.tsx
@@ -1,6 +1,6 @@
 import * as React from 'react';
 
-import { RedocNormalizedOptions, RedocRawOptions } from '../services/RedocNormalizedOptions';
+import { argValueToBoolean, RedocNormalizedOptions, RedocRawOptions } from '../services/RedocNormalizedOptions';
 import { ErrorBoundary } from './ErrorBoundary';
 import { Loading } from './Loading/Loading';
 import { Redoc } from './Redoc/Redoc';
@@ -15,7 +15,7 @@ export interface RedocStandaloneProps {
 
 export const RedocStandalone = function (props: RedocStandaloneProps) {
   const { spec, specUrl, options = {}, onLoaded } = props;
-  const hideLoading = options.hideLoading !== undefined;
+  const hideLoading = argValueToBoolean(options.hideLoading, false);
 
   const normalizedOpts = new RedocNormalizedOptions(options);
 
diff --git a/src/services/RedocNormalizedOptions.ts b/src/services/RedocNormalizedOptions.ts
index 58d4b8b0..e310a9ad 100644
--- a/src/services/RedocNormalizedOptions.ts
+++ b/src/services/RedocNormalizedOptions.ts
@@ -44,7 +44,7 @@ export interface RedocRawOptions {
   hideSchemaPattern?: boolean;
 }
 
-function argValueToBoolean(val?: string | boolean, defaultValue?: boolean): boolean {
+export function argValueToBoolean(val?: string | boolean, defaultValue?: boolean): boolean {
   if (val === undefined) {
     return defaultValue || false;
   }

From 919a5f02fb94ca869011d5eaf63ee71b61b60150 Mon Sep 17 00:00:00 2001
From: Roelof Kallenkoot <roelof000@gmail.com>
Date: Tue, 10 Aug 2021 15:56:27 +0200
Subject: [PATCH 16/43] feat: add github action to build docker images and push
 to ghcr.io on release (#1614)

---
 .github/workflows/main.yml | 45 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 45 insertions(+)
 create mode 100644 .github/workflows/main.yml

diff --git a/.github/workflows/main.yml b/.github/workflows/main.yml
new file mode 100644
index 00000000..42afcc4c
--- /dev/null
+++ b/.github/workflows/main.yml
@@ -0,0 +1,45 @@
+name: Publish Docker image
+on:
+  release:
+    types: [published]
+jobs:
+  push_to_registry:
+    name: Push Docker image to GitHub Packages
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
+    steps:
+      - name: Check out the repo
+        uses: actions/checkout@v2
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v1
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - name: Prepare
+        id: prep
+        run: |
+          DOCKER_IMAGE=ghcr.io/redocly/redoc/cli
+          VERSION=edge
+          if [[ $GITHUB_REF == refs/tags/* ]]; then
+            VERSION=${GITHUB_REF#refs/tags/}
+          elif [[ $GITHUB_REF == refs/heads/* ]]; then
+            VERSION=$(echo ${GITHUB_REF#refs/heads/} | sed -r 's#/+#-#g')
+          elif [[ $GITHUB_REF == refs/pull/* ]]; then
+            VERSION=pr-${{ github.event.number }}
+          fi
+          TAGS="${DOCKER_IMAGE}:${VERSION}"
+          if [ "${{ github.event_name }}" = "push" ]; then
+            TAGS="$TAGS,${DOCKER_IMAGE}:sha-${GITHUB_SHA::8}"
+          fi
+          echo ::set-output name=version::${VERSION}
+          echo ::set-output name=tags::${TAGS}
+          echo ::set-output name=created::$(date -u +'%Y-%m-%dT%H:%M:%SZ')
+      - name: Push to GitHub Packages
+        uses: docker/build-push-action@v2
+        with:
+          context: ./cli
+          push: ${{ github.event_name != 'pull_request' }}
+          tags: ${{ steps.prep.outputs.tags }}

From ddf297b11269ef515bd62771912a5609721d5e39 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Wed, 11 Aug 2021 12:59:31 +0300
Subject: [PATCH 17/43] fix: nullable object's fields were missing (#1721)

---
 src/components/Schema/Schema.tsx | 17 ++++++-----------
 src/services/models/Schema.ts    |  8 ++++++--
 2 files changed, 12 insertions(+), 13 deletions(-)

diff --git a/src/components/Schema/Schema.tsx b/src/components/Schema/Schema.tsx
index 8948e2b4..392a0f23 100644
--- a/src/components/Schema/Schema.tsx
+++ b/src/components/Schema/Schema.tsx
@@ -63,20 +63,15 @@ export class Schema extends React.Component<Partial<SchemaProps>> {
       return <OneOfSchema schema={schema} {...this.props} />;
     }
 
-    if (type && Array.isArray(type)) {
+    const types = Array.isArray(type) ? type : [type];
+    if (types.includes('object')) {
+      if (schema.fields?.length) {
+        return <ObjectSchema {...(this.props as any)} />;
+      }
+    } else if (types.includes('array')) {
       return <ArraySchema {...(this.props as any)} />;
     }
 
-    switch (type) {
-      case 'object':
-        if (schema.fields?.length) {
-          return <ObjectSchema {...(this.props as any)} />;
-        }
-        break;
-      case 'array':
-        return <ArraySchema {...(this.props as any)} />;
-    }
-
     // TODO: maybe adjust FieldDetails to accept schema
     const field = ({
       schema,
diff --git a/src/services/models/Schema.ts b/src/services/models/Schema.ts
index e5b36ae1..d79d738b 100644
--- a/src/services/models/Schema.ts
+++ b/src/services/models/Schema.ts
@@ -100,6 +100,10 @@ export class SchemaModel {
     this.activeOneOf = idx;
   }
 
+  hasType(type: string) {
+    return this.type === type || (Array.isArray(this.type) && this.type.includes(type));
+  }
+
   init(parser: OpenAPIParser, isChild: boolean) {
     const schema = this.schema;
     this.isCircular = schema['x-circular-ref'];
@@ -170,9 +174,9 @@ export class SchemaModel {
       return;
     }
 
-    if (this.type === 'object') {
+    if (this.hasType('object')) {
       this.fields = buildFields(parser, schema, this.pointer, this.options);
-    } else if ((this.type === 'array' || Array.isArray(this.type)) && schema.items) {
+    } else if (this.hasType('array') && schema.items) {
       this.items = new SchemaModel(parser, schema.items, this.pointer + '/items', this.options);
       this.displayType = pluralizeType(this.items.displayType);
       this.displayFormat = this.items.format;

From c904cdb7052dd9754d7be54e61ddb3f7f2044976 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Wed, 11 Aug 2021 13:11:02 +0300
Subject: [PATCH 18/43] chore: up version for release (#1722)

---
 package-lock.json | 4 ++--
 package.json      | 2 +-
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 79a0831f..73cfe473 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,11 +1,11 @@
 {
   "name": "redoc",
-  "version": "2.0.0-rc.55",
+  "version": "2.0.0-rc.56",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
-      "version": "2.0.0-rc.55",
+      "version": "2.0.0-rc.56",
       "license": "MIT",
       "dependencies": {
         "@babel/runtime": "^7.14.0",
diff --git a/package.json b/package.json
index ead71f3e..6f57959e 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "redoc",
-  "version": "2.0.0-rc.55",
+  "version": "2.0.0-rc.56",
   "description": "ReDoc",
   "repository": {
     "type": "git",

From d164699c4287e0308804aaf96853a98099761625 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Wed, 11 Aug 2021 13:25:02 +0300
Subject: [PATCH 19/43] chore: add change log for v2.0.0-rc.56(#1723)

---
 CHANGELOG.md | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index 56d0b06f..b73fb105 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,3 +1,24 @@
+# [2.0.0-rc.56](https://github.com/Redocly/redoc/compare/v2.0.0-rc.53...v2.0.0-rc.56) (2021-08-11)
+
+
+### Bug Fixes
+
+* handle empty object in security array ([#1678](https://github.com/Redocly/redoc/issues/1678)) ([9e1ea70](https://github.com/Redocly/redoc/commit/9e1ea703e56a71567b13d0d22e2d69945a22de4d))
+* hideLoading options in redoc standalone ([#1709](https://github.com/Redocly/redoc/issues/1709)) ([6a52a16](https://github.com/Redocly/redoc/commit/6a52a16d5b75a2955da7217c4a264f0fa8e98c89))
+* improve openapi 3.1 ([#1700](https://github.com/Redocly/redoc/issues/1700)) ([cd2d6f7](https://github.com/Redocly/redoc/commit/cd2d6f76e87c8385786a9c8e51c0d11c79d9707c))
+  - show contentEncoding on fields
+  - crash with OpenAPI 3.1 type as array of strings in requestBody
+  - nullable label not shown 
+* nullable object's fields were missing ([#1721](https://github.com/Redocly/redoc/issues/1721)) ([ddf297b](https://github.com/Redocly/redoc/commit/ddf297b11269ef515bd62771912a5609721d5e39))
+
+
+### Features
+
+* add github action to build docker images and push to ghcr.io on release ([#1614](https://github.com/Redocly/redoc/issues/1614)) ([919a5f0](https://github.com/Redocly/redoc/commit/919a5f02fb94ca869011d5eaf63ee71b61b60150))
+* add yaml highlight ([#1684](https://github.com/Redocly/redoc/issues/1684)) ([d724440](https://github.com/Redocly/redoc/commit/d72444008533623c87f238fe8758b1dd518b89eb))
+* added localization for some labels ([#1675](https://github.com/Redocly/redoc/issues/1675)) ([ec50858](https://github.com/Redocly/redoc/commit/ec50858ec47af08c5fe553266fe3c209fba97eae))
+
+
 # [2.0.0-rc.55](https://github.com/Redocly/redoc/compare/v2.0.0-rc.54...v2.0.0-rc.55) (2021-07-01)
 
 

From ccb18604a6c5d63ca4ae7ca2a928c9db69d5e1fc Mon Sep 17 00:00:00 2001
From: romanhotsiy <gotsijroman@gmail.com>
Date: Wed, 11 Aug 2021 13:32:46 +0300
Subject: [PATCH 20/43] chore(cli): v0.12.3

---
 cli/npm-shrinkwrap.json | 22 +++++++++++-----------
 cli/package.json        |  4 ++--
 2 files changed, 13 insertions(+), 13 deletions(-)

diff --git a/cli/npm-shrinkwrap.json b/cli/npm-shrinkwrap.json
index 0986cec5..117d9c06 100644
--- a/cli/npm-shrinkwrap.json
+++ b/cli/npm-shrinkwrap.json
@@ -1,12 +1,12 @@
 {
   "name": "redoc-cli",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "lockfileVersion": 2,
   "requires": true,
   "packages": {
     "": {
       "name": "redoc-cli",
-      "version": "0.12.2",
+      "version": "0.12.3",
       "license": "MIT",
       "dependencies": {
         "chokidar": "^3.5.1",
@@ -17,7 +17,7 @@
         "node-libs-browser": "^2.2.1",
         "react": "^17.0.1",
         "react-dom": "^17.0.1",
-        "redoc": "2.0.0-rc.55",
+        "redoc": "2.0.0-rc.56",
         "styled-components": "^5.3.0",
         "yargs": "^17.0.1"
       },
@@ -1751,9 +1751,9 @@
       }
     },
     "node_modules/redoc": {
-      "version": "2.0.0-rc.55",
-      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.55.tgz",
-      "integrity": "sha512-32sUHhc33m8zQKz2V7xREwlf05S52dDOkn7K0WMquu2GDl6ZquxmrQfqnlj0IPoVCWQPR+XosmmIJj4rZbqjeA==",
+      "version": "2.0.0-rc.56",
+      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.56.tgz",
+      "integrity": "sha512-ir2TtQ2d/1FqZWIoLmUZ3qvAAnO6jg8dt0SV75TanmfCXpEABcElXWH3mtUf6qKlvgDVt40diDCVuSvyPPxkAw==",
       "dependencies": {
         "@babel/runtime": "^7.14.0",
         "@redocly/openapi-core": "^1.0.0-beta.50",
@@ -1773,7 +1773,7 @@
         "path-browserify": "^1.0.1",
         "perfect-scrollbar": "^1.5.1",
         "polished": "^4.1.3",
-        "prismjs": "^1.24.0",
+        "prismjs": "^1.24.1",
         "prop-types": "^15.7.2",
         "react-tabs": "^3.2.2",
         "slugify": "~1.4.7",
@@ -3741,9 +3741,9 @@
       }
     },
     "redoc": {
-      "version": "2.0.0-rc.55",
-      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.55.tgz",
-      "integrity": "sha512-32sUHhc33m8zQKz2V7xREwlf05S52dDOkn7K0WMquu2GDl6ZquxmrQfqnlj0IPoVCWQPR+XosmmIJj4rZbqjeA==",
+      "version": "2.0.0-rc.56",
+      "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.0.0-rc.56.tgz",
+      "integrity": "sha512-ir2TtQ2d/1FqZWIoLmUZ3qvAAnO6jg8dt0SV75TanmfCXpEABcElXWH3mtUf6qKlvgDVt40diDCVuSvyPPxkAw==",
       "requires": {
         "@babel/runtime": "^7.14.0",
         "@redocly/openapi-core": "^1.0.0-beta.50",
@@ -3763,7 +3763,7 @@
         "path-browserify": "^1.0.1",
         "perfect-scrollbar": "^1.5.1",
         "polished": "^4.1.3",
-        "prismjs": "^1.24.0",
+        "prismjs": "^1.24.1",
         "prop-types": "^15.7.2",
         "react-tabs": "^3.2.2",
         "slugify": "~1.4.7",
diff --git a/cli/package.json b/cli/package.json
index 862d795e..379f5cfe 100644
--- a/cli/package.json
+++ b/cli/package.json
@@ -1,6 +1,6 @@
 {
   "name": "redoc-cli",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "description": "ReDoc's Command Line Interface",
   "main": "index.js",
   "bin": "index.js",
@@ -19,7 +19,7 @@
     "node-libs-browser": "^2.2.1",
     "react": "^17.0.1",
     "react-dom": "^17.0.1",
-    "redoc": "2.0.0-rc.55",
+    "redoc": "2.0.0-rc.56",
     "styled-components": "^5.3.0",
     "yargs": "^17.0.1"
   },

From e8412e8e93b177404aae5d437574e6047bb7d7e8 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Tue, 24 Aug 2021 21:44:27 -0400
Subject: [PATCH 21/43] docs(GSOD): Adds new quickstart doc (#1718)

---
 docs/quickstart/cli.md    | 112 ++++++++++++++++++++
 docs/quickstart/docker.md |  39 +++++++
 docs/quickstart/html.md   | 214 ++++++++++++++++++++++++++++++++++++++
 docs/quickstart/intro.md  |  44 ++++++++
 docs/quickstart/react.md  |  78 ++++++++++++++
 docs/sidebars.yaml        |  13 +++
 6 files changed, 500 insertions(+)
 create mode 100644 docs/quickstart/cli.md
 create mode 100644 docs/quickstart/docker.md
 create mode 100644 docs/quickstart/html.md
 create mode 100644 docs/quickstart/intro.md
 create mode 100644 docs/quickstart/react.md
 create mode 100644 docs/sidebars.yaml

diff --git a/docs/quickstart/cli.md b/docs/quickstart/cli.md
new file mode 100644
index 00000000..b0f2af85
--- /dev/null
+++ b/docs/quickstart/cli.md
@@ -0,0 +1,112 @@
+---
+title: Using the Redoc CLI
+---
+
+# Using the Redoc CLI
+
+With Redoc's command-line interface you can bundle your OpenAPI definition and API documentation
+(made with Redoc) into a zero-dependency HTML file and locally render your
+OpenAPI definition with Redoc.
+
+## Step 1 - Install Redoc CLI
+
+You can install the `redoc-cli` package globally using one of the following package managers:
+
+- [npm](https://docs.npmjs.com/about-npm)
+- [yarn](https://classic.yarnpkg.com/en/docs/getting-started)
+
+Or you can install `redoc-cli` using [npx](https://www.freecodecamp.org/news/npm-vs-npx-whats-the-difference/).
+
+### Install Redoc CLI with yarn
+
+To install the `redoc-cli` package globally with yarn: 
+
+```bash
+yarn global add redoc-cli
+```
+
+### Install Redoc with npm
+
+To install the `redoc-cli` package globally with npm: 
+
+```bash
+npm i -g redoc-cli
+```
+
+### Install with `npx`
+
+To install the `redoc-cli` package locally with `npx`, navigate to your project
+directory in your terminal, then use the following command:
+
+```bash
+npx redoc-cli
+```
+
+## Step 2 - Use the CLI
+
+### Redoc CLI commands
+
+The CLI includes the following commands:
+
+- **`redoc-cli serve [spec]`:** Starts a local server with Redoc. You must include the required parameter, spec, which is
+  a reference to an OpenAPI definition. Options include:
+    - `--ssr`: Implements a server-side rendering model. 
+    - `--watch`: Automatically reloads the server while you edit your OpenAPI definition.
+    - `--options`: Customizes your output using [Redoc options](https://redoc.ly/docs/api-reference-docs/configuration/).
+      To add nested options, use dot notation.
+- **`redoc-cli bundle [spec]`:** Bundles `spec` and Redoc into a zero-dependency HTML file. Options include:
+    - `-t` or `--template`: Uses custom [Handlebars](https://handlebarsjs.com/) templates to render your OpenAPI definition.
+    - `--templateOptions`: Adds template options you want to pass to your
+      custom Handlebars template. To add options, use dot notation.
+- **`--help`:** Prints help text for the Redoc CLI commands and options.
+- **`--version`:** Prints the version of the `redoc-cli` package you have installed.
+
+### Redoc CLI examples
+
+#### Bundle
+
+Bundle with the main color changed to `orange`:
+
+```bash
+redoc-cli bundle openapi.yaml --options.theme.colors.primary.main=orange
+```
+
+Bundle using a custom Handlebars template and add custom `templateOptions`:
+
+```bash
+redoc-cli bundle http://petstore.swagger.io/v2/swagger.json -t custom.hbs --templateOptions.metaDescription "Page meta description"
+```
+
+Sample Handlebars template:
+
+```handlebars
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf8" />
+        <title>{{title}}</title>
+        <!-- needed for adaptive design -->
+        <meta description="{{{templateOptions.metaDescription}}}">
+        <meta name="viewport" content="width=device-width, initial-scale=1">
+        <style>
+            body {
+            padding: 0;
+            margin: 0;
+            }
+        </style>
+        {{{redocHead}}}
+        {{#unless disableGoogleFont}}<link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">{{/unless}}
+    </head>
+    <body>
+      {{{redocHTML}}}
+    </body>
+</html>
+```
+
+#### Serve
+
+Serve with the `nativeScrollbars` option set to `true`:
+
+```bash
+redoc-cli serve  openapi/dist.yaml --options.nativeScrollbars
+```
diff --git a/docs/quickstart/docker.md b/docs/quickstart/docker.md
new file mode 100644
index 00000000..31539fdb
--- /dev/null
+++ b/docs/quickstart/docker.md
@@ -0,0 +1,39 @@
+---
+title: Using the Redoc Docker image
+---
+
+# Using the Redoc Docker image
+
+Redoc is available as a pre-built Docker image in [Docker Hub](https://hub.docker.com/r/redocly/redoc/).
+
+If you have [Docker](https://docs.docker.com/get-docker/) installed, pull the image with the following command:
+
+```docker
+docker pull redocly/redoc
+```
+
+Then run the image with the following command:
+
+```docker
+docker run -p 8080:80 redocly/redoc
+```
+
+The preview starts on port 8080, based on the port used in the command,
+and can be accessed at `http://localhost:8080`.
+To exit the preview, use `control+C`.
+
+By default Redoc starts with a demo Swagger Petstore OpenAPI definition located at
+http://petstore.swagger.io/v2/swagger.json. You can update this URL using
+the environment variable `SPEC_URL`. 
+
+For example:
+
+```bash
+docker run -p 8080:80 -e SPEC_URL=https://api.example.com/openapi.json redocly/redoc
+```
+
+## Using a Dockerfile
+
+You can also create a Dockerfile with some predefined environment variables. Check out
+a sample [Dockerfile](https://github.com/Redocly/redoc/blob/master/config/docker/Dockerfile)
+in our code repo.
\ No newline at end of file
diff --git a/docs/quickstart/html.md b/docs/quickstart/html.md
new file mode 100644
index 00000000..bfc8d267
--- /dev/null
+++ b/docs/quickstart/html.md
@@ -0,0 +1,214 @@
+---
+title: Using the Redoc HTML element
+---
+
+# Using the Redoc HTML element
+
+## TL;DR final code example
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Redoc</title>
+    <!-- needed for adaptive design -->
+    <meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+
+    <!--
+    Redoc doesn't change outer page styles
+    -->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+      }
+    </style>
+  </head>
+  <body>
+    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
+  </body>
+</html>
+
+```
+
+:::attention Running Redoc locally requires an HTTP server
+Loading local OpenAPI definitions is impossible without running a web server because of issues with
+[same-origin policy](https://developer.mozilla.org/en-US/docs/Web/Security/Same-origin_policy) and
+other security reasons. 
+:::
+
+### Running Redoc locally
+
+If you want to view your Redoc output locally, you can simulate an HTTP server.
+
+#### Using Redocly OpenAPI CLI
+
+Redocly OpenAPI CLI is an open source command-line tool that includes a command
+for simulating an HTTP server to provide a preview of your OpenAPI definition locally.
+
+If you have [OpenAPI CLI](https://redoc.ly/docs/cli/#installation-and-usage) installed, `cd` into your
+project directory and run the following command:
+
+```bash
+openapi preview-docs openapi.yaml
+```
+
+By default, without providing a port, the preview starts on port 8080, and can be accessed at `http://localhost:8080`.
+To exit the preview, use `control+C`.
+
+#### Using Python
+
+If you have [Python 3](https://www.python.org/downloads/) installed, `cd` into your
+project directory and run the following command:
+
+```python
+python3 -m http.server
+```
+
+If you have [Python 2](https://www.python.org/downloads/) installed, `cd` into your
+project directory and run the following command:
+
+```python
+python -m SimpleHTTPServer 8000
+```
+
+The output after entering the command provides the local URL where the preview can be accessed.
+To exit the preview, use `control-C`.
+
+#### Using Node.js
+
+If you have [Node.js](https://nodejs.org/en/download/) installed, install `http-server`
+using the following npm command:
+
+```bash
+npm install -g http-server
+```
+
+Then, `cd` into your project directory and run the following command:
+
+```node
+http-server
+```
+
+The output after entering the command provides the local URL where the preview can be accessed.
+To exit the preview, use `control-C`.
+
+## Step 1 - Install Redoc
+
+You can install Redoc using one of the following package managers:
+
+- [npm](https://docs.npmjs.com/about-npm)
+- [yarn](https://classic.yarnpkg.com/en/docs/getting-started)
+
+:::attention Initialize your package manager
+If you do not have a `package.json` file in your project directory,
+you need to add one by initializing npm or yarn in your project. Use the command `npm init` for npm,
+or `yarn init` for yarn. These initialization commands will lead you through the process
+of creating a `package.json` file in your project. 
+
+For more information, see 
+[Creating a package.json file](https://docs.npmjs.com/creating-a-package-json-file)
+in the npm documentation or [Yarn init](https://classic.yarnpkg.com/en/docs/cli/init/)
+in the yarn documentation.
+
+:::
+
+### Install Redoc with yarn
+
+After navigating to your project directory in your terminal, use the following command: 
+
+```bash
+yarn add redoc
+```
+
+### Install Redoc with npm
+
+After navigating to your project directory in your terminal, use the following command: 
+
+```bash
+npm i redoc
+```
+
+## Step 2 - Reference the Redoc script
+
+You can reference the Redoc script using either a link to the files hosted on a CDN
+or the files located in your `node modules` folder.
+
+### CDN link
+
+To reference the Redoc script with a CDN link:
+
+```html
+<script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
+```
+
+### Node modules link
+
+To reference the Redoc script with a node modules link:
+
+```html
+<script src="node_modules/redoc/bundles/redoc.standalone.js"> </script>
+```
+
+## Step 3 - Add the <redoc> element
+
+You can add the <redoc> element to your HTML page and reference your OpenAPI
+definition using the `spec-url` attribute, or you can initialize Redoc using
+a globally exposed Redoc object.
+
+### Using the `spec-url` attribute
+
+To add the <redoc> element with the `spec-url` attribute:
+
+```html
+<redoc spec-url="url/to/your/spec"></redoc>
+```
+
+#### Examples
+
+```html
+<redoc spec-url="http://petstore.swagger.io/v2/swagger.json"></redoc>
+```
+
+You can also use a local file (JSON or YAML) in your project, for instance:
+
+```html
+<redoc spec-url="dist.json"></redoc>
+```
+
+### Using a Redoc object
+
+To add the <redoc> element with a globally exposed Redoc object:
+
+```js
+Redoc.init(specOrSpecUrl, options, element, callback)
+```
+- `specOrSpecUrl`: Either a JSON object with the OpenAPI definition or a URL to the
+  definition in JSON or YAML format.
+- `options`: See [options object](https://redoc.ly/docs/api-reference-docs/configuration/) reference.
+- `element`: DOM element Redoc will be inserted into.
+- `callback`(optional): Callback to be called after Redoc has been fully rendered.
+  It is also called on errors with `error` as the first argument.
+
+#### Examples
+
+```html
+<script>
+Redoc.init('http://petstore.swagger.io/v2/swagger.json', {
+  scrollYOffset: 50
+}, document.getElementById('redoc-container'))
+</script>
+```
+
+You can also use a local file (JSON or YAML) in your project, for instance:
+
+```html
+<script>
+Redoc.init('dist.yaml', {
+  scrollYOffset: 50
+}, document.getElementById('redoc-container'))
+</script>
+```
\ No newline at end of file
diff --git a/docs/quickstart/intro.md b/docs/quickstart/intro.md
new file mode 100644
index 00000000..d1795604
--- /dev/null
+++ b/docs/quickstart/intro.md
@@ -0,0 +1,44 @@
+---
+title: Redoc quickstart guide
+---
+
+# Redoc quickstart guide
+
+This guide includes step-by-step instructions for how to get started using
+Redoc to render your OpenAPI definition.
+
+Redoc offers multiple options for rendering your OpenAPI definition.
+You should select the option that best fits your needs.
+
+The following options are supported:
+
+- **[Live demo](/redoc/quickstart/live-demo.md):**
+  The live demo offers a fast way to see how your OpenAPI will render with Redoc.
+- **[HTML element](/redoc/quickstart/html.md):**
+  Using the HTML element works well for typical website deployments.
+- **[React component](/redoc/quickstart/react.md):**
+  Using the React component is an option for users with a React-based application.
+- **[Docker image](/redoc/quickstart/docker.md):**
+  Using the Docker image works in a container-based deployment.
+- **[CLI](/redoc/quickstart/cli.md):**
+  Using the CLI is an option for users who prefer to use a command-line interface.
+
+## Before you start
+
+You will need an OpenAPI definition. For testing purposes, you can use one of the following sample OpenAPI definitions: 
+- OpenAPI 3.0
+    - [Rebilly Users OpenAPI Definition](https://raw.githubusercontent.com/Rebilly/api-definitions/main/openapi/users.yaml)
+    - [Swagger Petstore Sample OpenAPI Definition](https://petstore3.swagger.io/api/v3/openapi.json)
+- OpenAPI 2.0
+    - [Thingful OpenAPI Definition](https://raw.githubusercontent.com/thingful/openapi-spec/master/spec/swagger.yaml)
+    - [Fitbit Plus OpenAPI Definition](https://raw.githubusercontent.com/TwineHealth/TwineDeveloperDocs/master/spec/swagger.yaml)
+
+For more information on the OpenAPI specification, refer to the [Learning OpenAPI 3](https://redoc.ly/docs/resources/learning-openapi/)
+section in the documentation.
+
+## Live demo online
+
+If you want to see how ReDoc will render your OpenAPI definition, you can try it out online at https://redocly.github.io/redoc/.
+
+A version of the Swagger Petstore API is displayed by default.  To test it with your own OpenAPI definition, enter the URL for your
+definition and select the **TRY IT** button.
\ No newline at end of file
diff --git a/docs/quickstart/react.md b/docs/quickstart/react.md
new file mode 100644
index 00000000..ebc19845
--- /dev/null
+++ b/docs/quickstart/react.md
@@ -0,0 +1,78 @@
+---
+title: Using the Redoc React component
+---
+
+# Using the Redoc React component
+
+## Before you start
+
+Install the following dependencies required by Redoc if you do not already have them installed:
+
+- `react`
+- `react-dom`
+- `mobx`
+- `styled-components`
+- `core-js`
+
+If you have npm installed, you can install these dependencies using the following command:
+
+```js
+npm i react react-dom mobx styled-components core-js
+```
+
+## Step 1 - Import the `RedocStandalone` component
+
+```js
+import { RedocStandalone } from 'redoc';
+```
+
+## Step 2 - Use the component
+
+You can either link to your OpenAPI definition with a URL, using the following format:
+
+```react
+<RedocStandalone specUrl="url/to/your/spec"/>
+```
+
+Or you can pass your OpenAPI definition as an object, using the following format:
+
+```js
+<RedocStandalone spec={/* spec as an object */}/>
+```
+
+## Optional - Pass options
+
+Options can be passed into the RedocStandalone component to alter how it renders. 
+
+For example:
+
+```js
+<RedocStandalone
+  specUrl="http://petstore.swagger.io/v2/swagger.json"
+  options={{
+    nativeScrollbars: true,
+    theme: { colors: { primary: { main: '#dd5522' } } },
+  }}
+/>
+```
+
+For more information on configuration options, refer to the 
+[Configuration options for Reference docs](https://redoc.ly/docs/api-reference-docs/configuration/)
+section of the documentation. Options available for Redoc are noted,
+"Supported in Redoc CE".
+
+## Optional - Specify `onLoaded` callback
+
+You can also specify the `onLoaded` callback, which is called each time Redoc
+is fully rendered or when an error occurs (with an error as the first argument).
+
+```js
+<RedocStandalone
+  specUrl="http://petstore.swagger.io/v2/swagger.json"
+  onLoaded={error => {
+    if (!error) {
+      console.log('Yay!');
+    }
+  }}
+/>
+```
diff --git a/docs/sidebars.yaml b/docs/sidebars.yaml
new file mode 100644
index 00000000..2189f25b
--- /dev/null
+++ b/docs/sidebars.yaml
@@ -0,0 +1,13 @@
+redoc:
+  - group: Quickstart
+    expanded: false
+    page: redoc/quickstart/intro.md
+    pages:
+      - label: HTML element
+        page: redoc/quickstart/html.md
+      - label: React component
+        page: redoc/quickstart/react.md
+      - label: Docker image
+        page: redoc/quickstart/docker.md
+      - label: Command-line interface
+        page: redoc/quickstart/cli.md
\ No newline at end of file

From 683eabbbf077a4275e9986dcb6492f237f83b476 Mon Sep 17 00:00:00 2001
From: Adam Altman <adam@redoc.ly>
Date: Tue, 24 Aug 2021 21:40:16 -0500
Subject: [PATCH 22/43] docs: fix broken links in intro (#1730)

---
 docs/quickstart/intro.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/docs/quickstart/intro.md b/docs/quickstart/intro.md
index d1795604..e23f9d00 100644
--- a/docs/quickstart/intro.md
+++ b/docs/quickstart/intro.md
@@ -12,15 +12,15 @@ You should select the option that best fits your needs.
 
 The following options are supported:
 
-- **[Live demo](/redoc/quickstart/live-demo.md):**
+- **[Live demo](https://redocly.github.io/redoc/):**
   The live demo offers a fast way to see how your OpenAPI will render with Redoc.
-- **[HTML element](/redoc/quickstart/html.md):**
+- **[HTML element](./html.md):**
   Using the HTML element works well for typical website deployments.
-- **[React component](/redoc/quickstart/react.md):**
+- **[React component](./react.md):**
   Using the React component is an option for users with a React-based application.
-- **[Docker image](/redoc/quickstart/docker.md):**
+- **[Docker image](./docker.md):**
   Using the Docker image works in a container-based deployment.
-- **[CLI](/redoc/quickstart/cli.md):**
+- **[CLI](./cli.md):**
   Using the CLI is an option for users who prefer to use a command-line interface.
 
 ## Before you start
@@ -41,4 +41,4 @@ section in the documentation.
 If you want to see how ReDoc will render your OpenAPI definition, you can try it out online at https://redocly.github.io/redoc/.
 
 A version of the Swagger Petstore API is displayed by default.  To test it with your own OpenAPI definition, enter the URL for your
-definition and select the **TRY IT** button.
\ No newline at end of file
+definition and select the **TRY IT** button.

From 8afcf1b932a5578de0623559b3e40b95f0fdfe82 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Sun, 29 Aug 2021 21:27:18 -0400
Subject: [PATCH 23/43] Removes content that is now in documentation and adds
 link to docs

---
 README.md | 207 +++++++++---------------------------------------------
 1 file changed, 32 insertions(+), 175 deletions(-)

diff --git a/README.md b/README.md
index 6c63e3e6..60858d59 100644
--- a/README.md
+++ b/README.md
@@ -6,12 +6,10 @@
   [![Build Status](https://travis-ci.com/Redocly/redoc.svg?branch=master)](https://travis-ci.com/Redocly/redoc) [![Coverage Status](https://coveralls.io/repos/Redocly/redoc/badge.svg?branch=master&service=github)](https://coveralls.io/github/Redocly/redoc?branch=master) [![dependencies Status](https://david-dm.org/Redocly/redoc/status.svg)](https://david-dm.org/Redocly/redoc) [![devDependencies Status](https://david-dm.org/Redocly/redoc/dev-status.svg)](https://david-dm.org/Redocly/redoc#info=devDependencies) [![npm](http://img.shields.io/npm/v/redoc.svg)](https://www.npmjs.com/package/redoc) [![License](https://img.shields.io/npm/l/redoc.svg)](https://github.com/Redocly/redoc/blob/master/LICENSE)
 
   [![bundle size](http://img.badgesize.io/https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js?compression=gzip&max=300000)](https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js) [![npm](https://img.shields.io/npm/dm/redoc.svg)](https://www.npmjs.com/package/redoc) [![](https://data.jsdelivr.com/v1/package/npm/redoc/badge)](https://www.jsdelivr.com/package/npm/redoc) [![Docker Build Status](https://img.shields.io/docker/build/redocly/redoc.svg)](https://hub.docker.com/r/redocly/redoc/)
-
-
 </div>
 
-**This is README for `2.0` version of ReDoc (React based). README for `1.x` version is on the branch [v1.x](https://github.com/Redocly/redoc/tree/v1.x)**
-
+**This is the README for the `2.x` version of Redoc (React-based).** 
+**The README for the `1.x` version is on the [v1.x](https://github.com/Redocly/redoc/tree/v1.x) branch**
 
 ![ReDoc demo](https://raw.githubusercontent.com/Redocly/redoc/master/demo/redoc-demo.png)
 
@@ -20,34 +18,29 @@
 [<img alt="Deploy to Github" src="http://i.imgur.com/YZmaqk3.png" height="60px">](https://github.com/Rebilly/generator-openapi-repo#generator-openapi-repo--) [<img alt="ReDoc as a service" src="http://i.imgur.com/edqdCv6.png" height="60px">](https://redoc.ly) [<img alt="Customization services" src="http://i.imgur.com/c4sUF7M.png" height="60px">](https://redoc.ly/#services)
 
 ## Features
-- Extremely easy deployment
-- [redoc-cli](https://github.com/Redocly/redoc/blob/master/cli/README.md) with ability to bundle your docs into **zero-dependency** HTML file
-- Server Side Rendering ready
-- The widest OpenAPI v2.0 features support (yes, it supports even `discriminator`) <br>
-![](docs/images/discriminator-demo.gif)
-- OpenAPI 3.0 support
-- Basic OpenAPI 3.1 support
-- Neat **interactive** documentation for nested objects <br>
-![](docs/images/nested-demo.gif)
-- Code samples support (via vendor extension) <br>
-![](docs/images/code-samples-demo.gif)
+- [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
+- [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
+- [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
+  
+  [See an example](https://github.com/APIs-guru/create-react-app-redoc)
+- [Command-line interface to bundle your docs into a **zero-dependency** HTML file](https://redoc.ly/docs/redoc/quickstart/cli/)
 - Responsive three-panel design with menu/scrolling synchronization
-- Integrate API Introduction into side menu - ReDoc takes advantage of markdown headings from OpenAPI description field. It pulls them into side menu and also supports deep linking.
-- High-level grouping in side-menu via [`x-tagGroups`](docs/redoc-vendor-extensions.md#x-tagGroups) vendor extension
-- Simple integration with `create-react-app` ([sample](https://github.com/APIs-guru/create-react-app-redoc))
-- Branding/customizations via [`theme` option](#redoc-options-object)
-
-## Roadmap
-  - [x] ~~[OpenAPI v3.0 support](https://github.com/Redocly/redoc/issues/312)~~
-  - [x] ~~performance optimizations~~
-  - [x] ~~better navigation (menu improvements + search)~~
-  - [x] ~~React rewrite~~
-  - [x] ~~docs pre-rendering (performance and SEO)~~
-  - [ ] ability to simple branding/styling
+- Deep linking support
+- Ability to integrate your API introduction into the side menu
+- High-level grouping in side-menu via [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) vendor extension
+- Branding/customizations using the [`theme` option](https://redoc.ly/docs/api-reference-docs/configuration/theming/)
+- OpenAPI v3.0 support
+- Basic OpenAPI v3.1 support
+- Broad OpenAPI v2.0 feature support (yes, it supports even `discriminator`) <br>
+  ![](docs/images/discriminator-demo.gif)
+- Neat **interactive** documentation for nested objects <br>
+  ![](docs/images/nested-demo.gif)
+- Code samples support (via vendor extension) <br>
+  ![](docs/images/code-samples-demo.gif)
 
 ## Releases
-**Important:** all the 2.x releases are deployed to npm and can be used via jsdeliver:
-- particular release, e.g. `v2.0.0-alpha.15`: https://cdn.jsdelivr.net/npm/redoc@2.0.0-alpha.17/bundles/redoc.standalone.js
+**Important:** all the 2.x releases are deployed to npm and can be used with jsdeliver:
+- particular release, for example, `v2.0.0-alpha.15`: https://cdn.jsdelivr.net/npm/redoc@2.0.0-alpha.17/bundles/redoc.standalone.js
 - `next` release: https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js
 
 Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(deprecated)**:
@@ -64,153 +57,34 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
 | 1.18.x        | 2.0                   |
 | 1.17.x        | 2.0                   |
 
-## Some Real-life usages
+## Showcase
 - [Rebilly](https://api-reference.rebilly.com/)
 - [Docker Engine](https://docs.docker.com/engine/api/v1.25/)
 - [Zuora](https://www.zuora.com/developer/api-reference/)
 - [Discourse](http://docs.discourse.org)
 - [Commbox](https://www.commbox.io/api/)
 - [APIs.guru](https://apis.guru/api-doc/)
-- [FastAPI](https://github.com/tiangolo/fastapi)
 - [BoxKnight](https://www.docs.boxknight.com/)
 
 ## Deployment
-
-### TL;DR
-
-```html
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>ReDoc</title>
-    <!-- needed for adaptive design -->
-    <meta charset="utf-8"/>
-    <meta name="viewport" content="width=device-width, initial-scale=1">
-    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
-
-    <!--
-    ReDoc doesn't change outer page styles
-    -->
-    <style>
-      body {
-        margin: 0;
-        padding: 0;
-      }
-    </style>
-  </head>
-  <body>
-    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
-    <script src="https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js"> </script>
-  </body>
-</html>
-```
-That's all folks!
-
-**IMPORTANT NOTE:** if you work with untrusted user spec, use `untrusted-spec` [option](#redoc-options-object) to prevent XSS security risks.
-
-### 1. Install ReDoc (skip this step for CDN)
-Install using [npm](https://docs.npmjs.com/getting-started/what-is-npm):
-
-    npm i redoc
-
-or using [yarn](https://yarnpkg.com):
-
-    yarn add redoc
-
-### 2. Reference redoc script in HTML
-For **CDN**:
-```html
-<script src="https://cdn.jsdelivr.net/npm/redoc/bundles/redoc.standalone.js"> </script>
-```
-
-For npm:
-```html
-<script src="node_modules/redoc/bundles/redoc.standalone.js"> </script>
-```
-
-### 3. Add `<redoc>` element to your page
-```html
-<redoc spec-url="url/to/your/spec"></redoc>
-```
-
-### 4. Enjoy :smile:
-
-
-## Usage as a React component
-
-Install peer dependencies required by ReDoc if you don't have them installed already:
-
-    npm i react react-dom mobx styled-components core-js
-
-Import `RedocStandalone` component from 'redoc' module:
-
-```js
-import { RedocStandalone } from 'redoc';
-```
-
-and use it somewhere in your component:
-
-```js
-<RedocStandalone specUrl="url/to/your/spec"/>
-```
-
-or
-
-```js
-<RedocStandalone spec={/* spec as an object */}/>
-```
-
-Also you can pass options:
-
-```js
-<RedocStandalone
-  specUrl="https://api.redoc.ly/registry/rebilly/core-api/core/bundle/master/openapi.yaml"
-  options={{
-    nativeScrollbars: true,
-    theme: { colors: { primary: { main: '#dd5522' } } },
-  }}
-/>
-```
-
-Here are detailed [options docs](#redoc-options-object).
-
-You can also specify `onLoaded` callback which will be called each time Redoc has been fully rendered or when error occurs (with an error as the first argument). *NOTE*: It may be called multiply times if you change component properties
-
-```js
-<RedocStandalone
-  specUrl="https://api.redoc.ly/registry/rebilly/core-api/core/bundle/master/openapi.yaml"
-  onLoaded={error => {
-    if (!error) {
-      console.log('Yay!');
-    }
-  }}
-/>
-```
+For step-by-step instructions for how to get started using Redoc
+to render your OpenAPI definition, refer to the 
+[Redoc quickstart guide](https://redoc.ly/docs/redoc/quickstart/intro/).
 
 [**IE11 Support Notes**](docs/usage-with-ie11.md)
 
-## The Docker way
-
-ReDoc is available as pre-built Docker image in official [Docker Hub repository](https://hub.docker.com/r/redocly/redoc/). You may simply pull & run it:
-
-    docker pull redocly/redoc
-    docker run -p 8080:80 redocly/redoc
-
-Also you may rewrite some predefined environment variables defined in [Dockerfile](./config/docker/Dockerfile). By default ReDoc starts with demo Petstore spec located at `http://petstore.swagger.io/v2/swagger.json`, but you may change this URL using environment variable `SPEC_URL`:
-
-    docker run -p 8080:80 -e SPEC_URL=https://api.example.com/openapi.json redocly/redoc
-
 ## ReDoc CLI
-
-[See here](https://github.com/Redocly/redoc/blob/master/cli/README.md)
+For more information on Redoc's commmand-line interface, refer to
+[Using the Redoc CLI](https://redoc.ly/docs/redoc/quickstart/cli/).
 
 ## Configuration
 
 ### Security Definition location
-You can inject Security Definitions widget into any place of your specification `description`. Check out details [here](docs/security-definitions-injection.md).
+You can inject the Security Definitions widget into any place in your definition `description`.
+For more information, refer to [Security definitions injection](docs/security-definitions-injection.md).
 
 ### Swagger vendor extensions
-ReDoc makes use of the following [vendor extensions](https://swagger.io/specification/#specificationExtensions):
+Redoc uses the following [vendor extensions](https://swagger.io/specification/#specificationExtensions):
 * [`x-logo`](docs/redoc-vendor-extensions.md#x-logo) - is used to specify API logo
 * [`x-traitTag`](docs/redoc-vendor-extensions.md#x-traitTag) - useful for handling out common things like Pagination, Rate-Limits, etc
 * [`x-codeSamples`](docs/redoc-vendor-extensions.md#x-codeSamples) - specify operation code samples
@@ -226,7 +100,7 @@ ReDoc makes use of the following [vendor extensions](https://swagger.io/specific
 * [`x-explicitMappingOnly`](docs/redoc-vendor-extensions.md#x-explicitMappingOnly) - In Schemas, display a more descriptive property name in objects with additionalProperties when viewing the property list with an object
 
 ### `<redoc>` options object
-You can use all of the following options with standalone version on <redoc> tag by kebab-casing them, e.g. `scrollYOffset` becomes `scroll-y-offset` and `expandResponses` becomes `expand-responses`.
+You can use all of the following options with the standalone version of the <redoc> tag by kebab-casing them. For example, `scrollYOffset` becomes `scroll-y-offset`, and `expandResponses` becomes `expand-responses`.
 
 * `disableSearch` - disable search indexing and search box.
 * `expandDefaultServerVariables` - enable expanding default server variables, default `false`.
@@ -316,23 +190,6 @@ You can use all of the following options with standalone version on <redoc> tag
   * `width`: '40%'
   * `textColor`: '#ffffff'
 
-## Advanced usage of standalone version
-Instead of adding `spec-url` attribute to the `<redoc>` element you can initialize ReDoc via globally exposed `Redoc` object:
-```js
-Redoc.init(specOrSpecUrl, options, element, callback?)
-```
-
-- `specOrSpecUrl` is either JSON object with specification or an URL to the spec in `JSON` or `YAML` format
-- `options` [options object](#redoc-options-object)
-- `element` DOM element to put ReDoc into
-- `callback` (optional) - callback to be called after Redoc has been fully rendered. It is also called on errors with error as the first argument
-
-```js
-Redoc.init('http://petstore.swagger.io/v2/swagger.json', {
-  scrollYOffset: 50
-}, document.getElementById('redoc-container'))
-```
-
 -----------
 ## Development
 see [CONTRIBUTING.md](.github/CONTRIBUTING.md)

From a8e0c296852661dec1dcad2388d7589f9e0d3609 Mon Sep 17 00:00:00 2001
From: Andriy Zaleskyy <zal3sky@gmail.com>
Date: Tue, 31 Aug 2021 15:39:55 +0300
Subject: [PATCH 24/43] fix: Schema for events incorrectly omits readOnly and
 includes writeOnly (#1720 #1540)

---
 demo/openapi.yaml                             |  4 +--
 src/components/Parameters/Parameters.tsx      |  3 ++-
 src/services/RedocNormalizedOptions.ts        |  2 +-
 .../__tests__/models/RequestBody.test.ts      | 27 +++++++++++++++++++
 .../__tests__/models/Response.test.ts         | 22 ++++++++++-----
 src/services/models/MediaType.ts              |  2 +-
 src/services/models/Operation.ts              | 25 ++++++++++-------
 src/services/models/RequestBody.ts            | 17 +++++++-----
 src/services/models/Response.ts               | 21 +++++++++------
 9 files changed, 88 insertions(+), 35 deletions(-)
 create mode 100644 src/services/__tests__/models/RequestBody.test.ts

diff --git a/demo/openapi.yaml b/demo/openapi.yaml
index 74c16b70..c570cc60 100644
--- a/demo/openapi.yaml
+++ b/demo/openapi.yaml
@@ -1193,7 +1193,7 @@ x-webhooks:
       summary: New pet
       description: Information about a new pet in the systems
       operationId: newPet
-      tags: 
+      tags:
         - pet
       requestBody:
         content:
@@ -1202,4 +1202,4 @@ x-webhooks:
               $ref: "#/components/schemas/Pet"
       responses:
         "200":
-          description: Return a 200 status to indicate that the data was received successfully
\ No newline at end of file
+          description: Return a 200 status to indicate that the data was received successfully
diff --git a/src/components/Parameters/Parameters.tsx b/src/components/Parameters/Parameters.tsx
index 17ab9c48..eb3d2d61 100644
--- a/src/components/Parameters/Parameters.tsx
+++ b/src/components/Parameters/Parameters.tsx
@@ -69,13 +69,14 @@ function DropdownWithinHeader(props) {
 
 export function BodyContent(props: { content: MediaContentModel; description?: string }): JSX.Element {
   const { content, description } = props;
+  const { isRequestType } = content;
   return (
     <MediaTypesSwitch content={content} renderDropdown={DropdownWithinHeader}>
       {({ schema }) => {
         return (
           <>
             {description !== undefined && <Markdown source={description} />}
-            <Schema skipReadOnly={true} key="schema" schema={schema} />
+            <Schema skipReadOnly={isRequestType} key="schema" schema={schema} />
           </>
         );
       }}
diff --git a/src/services/RedocNormalizedOptions.ts b/src/services/RedocNormalizedOptions.ts
index e310a9ad..c2407b97 100644
--- a/src/services/RedocNormalizedOptions.ts
+++ b/src/services/RedocNormalizedOptions.ts
@@ -49,7 +49,7 @@ export function argValueToBoolean(val?: string | boolean, defaultValue?: boolean
     return defaultValue || false;
   }
   if (typeof val === 'string') {
-    return val === 'false' ? false : true;
+    return val !== 'false';
   }
   return val;
 }
diff --git a/src/services/__tests__/models/RequestBody.test.ts b/src/services/__tests__/models/RequestBody.test.ts
new file mode 100644
index 00000000..554a1222
--- /dev/null
+++ b/src/services/__tests__/models/RequestBody.test.ts
@@ -0,0 +1,27 @@
+import { RequestBodyModel } from '../../models/RequestBody';
+import { OpenAPIParser } from '../../OpenAPIParser';
+import { RedocNormalizedOptions } from '../../RedocNormalizedOptions';
+
+const opts = new RedocNormalizedOptions({});
+describe('Models', () => {
+  describe('RequestBodyModel', () => {
+    let parser, props;
+
+    beforeEach(() => {
+      parser = new OpenAPIParser({ openapi: '3.0.0' } as any, undefined, opts);
+      props = {
+        parser,
+        infoOrRef: {},
+        options: opts,
+        isEvent: false,
+      };
+    });
+
+    test('should work with default props', () => {
+      const consoleError = jest.spyOn(global.console, 'error');
+      const req = new RequestBodyModel(props);
+      expect(consoleError).not.toHaveBeenCalled();
+      expect(req).toEqual({ description: '', required: false });
+    });
+  });
+});
diff --git a/src/services/__tests__/models/Response.test.ts b/src/services/__tests__/models/Response.test.ts
index 3fb220f2..ae3c1fd1 100644
--- a/src/services/__tests__/models/Response.test.ts
+++ b/src/services/__tests__/models/Response.test.ts
@@ -5,30 +5,38 @@ import { RedocNormalizedOptions } from '../../RedocNormalizedOptions';
 const opts = new RedocNormalizedOptions({});
 describe('Models', () => {
   describe('ResponseModel', () => {
-    let parser;
+    let parser, props;
 
     beforeEach(() => {
       parser = new OpenAPIParser({ openapi: '3.0.0' } as any, undefined, opts);
+      props = {
+        parser,
+        defaultAsError: false,
+        infoOrRef: {},
+        options: opts,
+        isEvent: false,
+        code: 'default',
+      };
     });
 
     test('should calculate response type based on code', () => {
-      let resp = new ResponseModel(parser, '200', false, {}, opts);
+      let resp = new ResponseModel({...props, code: '200' });
       expect(resp.type).toEqual('success');
-      resp = new ResponseModel(parser, '120', false, {}, opts);
+      resp = new ResponseModel({...props, code: '120' });
       expect(resp.type).toEqual('info');
-      resp = new ResponseModel(parser, '301', false, {}, opts);
+      resp = new ResponseModel({...props, code: '301' });
       expect(resp.type).toEqual('redirect');
-      resp = new ResponseModel(parser, '400', false, {}, opts);
+      resp = new ResponseModel({...props, code: '400' });
       expect(resp.type).toEqual('error');
     });
 
     test('default should be successful by default', () => {
-      const resp = new ResponseModel(parser, 'default', false, {}, opts);
+      const resp = new ResponseModel({...props, code: 'default' });
       expect(resp.type).toEqual('success');
     });
 
     test('default should be error if defaultAsError is true', () => {
-      const resp = new ResponseModel(parser, 'default', true, {}, opts);
+      const resp = new ResponseModel({...props, code: 'default', defaultAsError: true });
       expect(resp.type).toEqual('error');
     });
   });
diff --git a/src/services/models/MediaType.ts b/src/services/models/MediaType.ts
index 9283fbae..8987fbbb 100644
--- a/src/services/models/MediaType.ts
+++ b/src/services/models/MediaType.ts
@@ -51,8 +51,8 @@ export class MediaTypeModel {
   generateExample(parser: OpenAPIParser, info: OpenAPIMediaType) {
     const samplerOptions = {
       skipReadOnly: this.isRequestType,
-      skipNonRequired: this.isRequestType && this.onlyRequiredInSamples,
       skipWriteOnly: !this.isRequestType,
+      skipNonRequired: this.isRequestType && this.onlyRequiredInSamples,
       maxSampleDepth: 10,
     };
     if (this.schema && this.schema.oneOf) {
diff --git a/src/services/models/Operation.ts b/src/services/models/Operation.ts
index d00461a1..5b1b5aca 100644
--- a/src/services/models/Operation.ts
+++ b/src/services/models/Operation.ts
@@ -76,6 +76,7 @@ export class OperationModel implements IMenuItem {
   extensions: Record<string, any>;
   isCallback: boolean;
   isWebhook: boolean;
+  isEvent: boolean;
 
   constructor(
     private parser: OpenAPIParser,
@@ -98,7 +99,8 @@ export class OperationModel implements IMenuItem {
     this.operationId = operationSpec.operationId;
     this.path = operationSpec.pathName;
     this.isCallback = isCallback;
-    this.isWebhook = !!operationSpec.isWebhook;
+    this.isWebhook = operationSpec.isWebhook;
+    this.isEvent = this.isCallback || this.isWebhook;
 
     this.name = getOperationSummary(operationSpec);
 
@@ -171,8 +173,12 @@ export class OperationModel implements IMenuItem {
   @memoize
   get requestBody() {
     return (
-      this.operationSpec.requestBody &&
-      new RequestBodyModel(this.parser, this.operationSpec.requestBody, this.options)
+      this.operationSpec.requestBody && new RequestBodyModel({
+        parser: this.parser,
+        infoOrRef: this.operationSpec.requestBody,
+        options: this.options,
+        isEvent: this.isEvent,
+      })
     );
   }
 
@@ -240,13 +246,14 @@ export class OperationModel implements IMenuItem {
         return isStatusCode(code);
       }) // filter out other props (e.g. x-props)
       .map((code) => {
-        return new ResponseModel(
-          this.parser,
+        return new ResponseModel({
+          parser: this.parser,
           code,
-          hasSuccessResponses,
-          this.operationSpec.responses[code],
-          this.options,
-        );
+          defaultAsError: hasSuccessResponses,
+          infoOrRef: this.operationSpec.responses[code],
+          options: this.options,
+          isEvent: this.isEvent,
+        });
       });
   }
 
diff --git a/src/services/models/RequestBody.ts b/src/services/models/RequestBody.ts
index f3b45959..3ca3dc21 100644
--- a/src/services/models/RequestBody.ts
+++ b/src/services/models/RequestBody.ts
@@ -4,22 +4,27 @@ import { OpenAPIParser } from '../OpenAPIParser';
 import { RedocNormalizedOptions } from '../RedocNormalizedOptions';
 import { MediaContentModel } from './MediaContent';
 
+type RequestBodyProps = {
+  parser: OpenAPIParser;
+  infoOrRef: Referenced<OpenAPIRequestBody>;
+  options: RedocNormalizedOptions;
+  isEvent: boolean;
+}
+
 export class RequestBodyModel {
   description: string;
   required: boolean;
   content?: MediaContentModel;
 
-  constructor(
-    parser: OpenAPIParser,
-    infoOrRef: Referenced<OpenAPIRequestBody>,
-    options: RedocNormalizedOptions,
-  ) {
+  constructor(props: RequestBodyProps) {
+    const { parser, infoOrRef, options, isEvent } = props;
+    const isRequest = isEvent ? false : true;
     const info = parser.deref(infoOrRef);
     this.description = info.description || '';
     this.required = !!info.required;
     parser.exitRef(infoOrRef);
     if (info.content !== undefined) {
-      this.content = new MediaContentModel(parser, info.content, true, options);
+      this.content = new MediaContentModel(parser, info.content, isRequest, options);
     }
   }
 }
diff --git a/src/services/models/Response.ts b/src/services/models/Response.ts
index f50ee0f1..d3ed554a 100644
--- a/src/services/models/Response.ts
+++ b/src/services/models/Response.ts
@@ -8,6 +8,15 @@ import { RedocNormalizedOptions } from '../RedocNormalizedOptions';
 import { FieldModel } from './Field';
 import { MediaContentModel } from './MediaContent';
 
+type ResponseProps = {
+  parser: OpenAPIParser,
+  code: string,
+  defaultAsError: boolean,
+  infoOrRef: Referenced<OpenAPIResponse>,
+  options: RedocNormalizedOptions,
+  isEvent: boolean,
+}
+
 export class ResponseModel {
   @observable
   expanded: boolean = false;
@@ -19,13 +28,9 @@ export class ResponseModel {
   type: string;
   headers: FieldModel[] = [];
 
-  constructor(
-    parser: OpenAPIParser,
-    code: string,
-    defaultAsError: boolean,
-    infoOrRef: Referenced<OpenAPIResponse>,
-    options: RedocNormalizedOptions,
-  ) {
+  constructor(props: ResponseProps) {
+    const { parser, code, defaultAsError, infoOrRef, options, isEvent } = props;
+    const isRequest = isEvent ? true : false;
     makeObservable(this);
 
     this.expanded = options.expandResponses === 'all' || options.expandResponses[code];
@@ -34,7 +39,7 @@ export class ResponseModel {
     parser.exitRef(infoOrRef);
     this.code = code;
     if (info.content !== undefined) {
-      this.content = new MediaContentModel(parser, info.content, false, options);
+      this.content = new MediaContentModel(parser, info.content, isRequest, options);
     }
 
     if (info['x-summary'] !== undefined) {

From a7ed8ddd984bf2b40f3de5eca69a486095413f93 Mon Sep 17 00:00:00 2001
From: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>
Date: Wed, 1 Sep 2021 13:48:46 +0200
Subject: [PATCH 25/43] Apply suggestions from code review

---
 README.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index 60858d59..826db0fa 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@
 - Responsive three-panel design with menu/scrolling synchronization
 - Deep linking support
 - Ability to integrate your API introduction into the side menu
-- High-level grouping in side-menu via [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) vendor extension
+- High-level grouping in side-menu via [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
 - Branding/customizations using the [`theme` option](https://redoc.ly/docs/api-reference-docs/configuration/theming/)
 - OpenAPI v3.0 support
 - Basic OpenAPI v3.1 support
@@ -83,8 +83,8 @@ For more information on Redoc's commmand-line interface, refer to
 You can inject the Security Definitions widget into any place in your definition `description`.
 For more information, refer to [Security definitions injection](docs/security-definitions-injection.md).
 
-### Swagger vendor extensions
-Redoc uses the following [vendor extensions](https://swagger.io/specification/#specificationExtensions):
+### OpenAPI specification extensions
+Redoc uses the following [specification extensions](https://swagger.io/specification/#specificationExtensions):
 * [`x-logo`](docs/redoc-vendor-extensions.md#x-logo) - is used to specify API logo
 * [`x-traitTag`](docs/redoc-vendor-extensions.md#x-traitTag) - useful for handling out common things like Pagination, Rate-Limits, etc
 * [`x-codeSamples`](docs/redoc-vendor-extensions.md#x-codeSamples) - specify operation code samples

From e7f7d963bd695731d71a41dd6d85a121fe09ddc3 Mon Sep 17 00:00:00 2001
From: Swapnil Ogale <swapnilogale@gmail.com>
Date: Wed, 1 Sep 2021 22:03:57 +1000
Subject: [PATCH 26/43] Update README.md

Co-authored-by: Adam Altman <adam@rebilly.com>
---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 826db0fa..855dac49 100644
--- a/README.md
+++ b/README.md
@@ -27,7 +27,7 @@
 - Responsive three-panel design with menu/scrolling synchronization
 - Deep linking support
 - Ability to integrate your API introduction into the side menu
-- High-level grouping in side-menu via [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
+- High-level grouping in side-menu with [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
 - Branding/customizations using the [`theme` option](https://redoc.ly/docs/api-reference-docs/configuration/theming/)
 - OpenAPI v3.0 support
 - Basic OpenAPI v3.1 support

From f8925facf822f9bdb1cb2d3d14aea644d4e2840f Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Sun, 12 Sep 2021 21:41:29 -0400
Subject: [PATCH 27/43] Updates readme with about section and organizes
 features list

---
 README.md | 93 +++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 77 insertions(+), 16 deletions(-)

diff --git a/README.md b/README.md
index 855dac49..9ed57fa8 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 <div align="center">
   <img alt="ReDoc logo" src="https://raw.githubusercontent.com/Redocly/redoc/master/docs/images/redoc-logo.png" width="400px" />
 
-  **OpenAPI/Swagger-generated API Reference Documentation**
+  # Generate interactive API documentation from OpenAPI definitions
 
   [![Build Status](https://travis-ci.com/Redocly/redoc.svg?branch=master)](https://travis-ci.com/Redocly/redoc) [![Coverage Status](https://coveralls.io/repos/Redocly/redoc/badge.svg?branch=master&service=github)](https://coveralls.io/github/Redocly/redoc?branch=master) [![dependencies Status](https://david-dm.org/Redocly/redoc/status.svg)](https://david-dm.org/Redocly/redoc) [![devDependencies Status](https://david-dm.org/Redocly/redoc/dev-status.svg)](https://david-dm.org/Redocly/redoc#info=devDependencies) [![npm](http://img.shields.io/npm/v/redoc.svg)](https://www.npmjs.com/package/redoc) [![License](https://img.shields.io/npm/l/redoc.svg)](https://github.com/Redocly/redoc/blob/master/LICENSE)
 
@@ -11,30 +11,60 @@
 **This is the README for the `2.x` version of Redoc (React-based).** 
 **The README for the `1.x` version is on the [v1.x](https://github.com/Redocly/redoc/tree/v1.x) branch**
 
+## About Redoc
+
+Redoc is an open-source tool for generating OpenAPI(aka Swagger) definitions. By default
+Redoc offers a three-panel, responsive layout: the left panel contains a search bar and navigation menu,
+the central panel contains the documentation, and the right panel contains request and response
+examples. 
+
 ![ReDoc demo](https://raw.githubusercontent.com/Redocly/redoc/master/demo/redoc-demo.png)
 
-## [Live demo](http://redocly.github.io/redoc/)
+## Live demo
 
-[<img alt="Deploy to Github" src="http://i.imgur.com/YZmaqk3.png" height="60px">](https://github.com/Rebilly/generator-openapi-repo#generator-openapi-repo--) [<img alt="ReDoc as a service" src="http://i.imgur.com/edqdCv6.png" height="60px">](https://redoc.ly) [<img alt="Customization services" src="http://i.imgur.com/c4sUF7M.png" height="60px">](https://redoc.ly/#services)
+If you want to see how ReDoc will render your OpenAPI definition,
+you can try it out online at https://redocly.github.io/redoc/.
+
+A version of the Swagger Petstore API is displayed by default.
+To test it with your own OpenAPI definition,
+enter the URL for your definition and select **TRY IT**.
+
+## Redoc vs. Redocly Reference docs
+
+Redoc Community Edition is free open-source software (OSS).
+Redocly has developed extensive enhancements on top of Redoc Community Edition's open core, creating Redocly Reference Docs.
+See [Comparison Redoc CE vs. Redocly Reference Docs](https://redoc.ly/redoc-vs-reference/)
+for the main differences between the Redoc Community Edition and Redocly Reference Docs.
+
+## Deploy to GitHub
+[<img alt="Deploy to Github" src="http://i.imgur.com/YZmaqk3.png" height="60px">](https://github.com/Rebilly/generator-openapi-repo#generator-openapi-repo--)
+
+## Redoc as a service
+[<img alt="Redoc as a service" src="http://i.imgur.com/edqdCv6.png" height="60px">](https://redoc.ly/workflows)
 
 ## Features
-- [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
-- [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
-- [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
-  
-  [See an example](https://github.com/APIs-guru/create-react-app-redoc)
-- [Command-line interface to bundle your docs into a **zero-dependency** HTML file](https://redoc.ly/docs/redoc/quickstart/cli/)
 - Responsive three-panel design with menu/scrolling synchronization
+- [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
 - Deep linking support
+- [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
 - Ability to integrate your API introduction into the side menu
-- High-level grouping in side-menu with [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
+- [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
+
+  [Example repo](https://github.com/APIs-guru/create-react-app-redoc)
+- [Command-line interface to bundle your docs into a **zero-dependency** HTML file](https://redoc.ly/docs/redoc/quickstart/cli/)
+- Neat **interactive** documentation for nested objects <br>
+  ![](docs/images/nested-demo.gif)
+
+## Customization options
+[<img alt="Customization services" src="http://i.imgur.com/c4sUF7M.png" height="60px">](https://redoc.ly/#services)
+- High-level grouping in side-menu with the [`x-tagGroups`](https://redoc.ly/docs/api-reference-docs/specification-extensions/x-tag-groups/) specification extension
 - Branding/customizations using the [`theme` option](https://redoc.ly/docs/api-reference-docs/configuration/theming/)
+
+## Support
 - OpenAPI v3.0 support
 - Basic OpenAPI v3.1 support
 - Broad OpenAPI v2.0 feature support (yes, it supports even `discriminator`) <br>
   ![](docs/images/discriminator-demo.gif)
-- Neat **interactive** documentation for nested objects <br>
-  ![](docs/images/nested-demo.gif)
 - Code samples support (via vendor extension) <br>
   ![](docs/images/code-samples-demo.gif)
 
@@ -44,7 +74,7 @@
 - `next` release: https://cdn.jsdelivr.net/npm/redoc@next/bundles/redoc.standalone.js
 
 Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(deprecated)**:
-- particular release, e.g. `v1.2.0`: https://rebilly.github.io/ReDoc/releases/v1.2.0/redoc.min.js
+- particular release, for example `v1.2.0`: https://rebilly.github.io/ReDoc/releases/v1.2.0/redoc.min.js
 - `v1.x.x` release: https://rebilly.github.io/ReDoc/releases/v1.x.x/redoc.min.js
 - `latest` release: https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js - it will point to latest 1.x.x release since 2.x releases are not hosted on this CDN but on unpkg.
 
@@ -67,15 +97,46 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
 - [BoxKnight](https://www.docs.boxknight.com/)
 
 ## Deployment
+
+### TL;DR final code example
+
+```html
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>Redoc</title>
+    <!-- needed for adaptive design -->
+    <meta charset="utf-8"/>
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <link href="https://fonts.googleapis.com/css?family=Montserrat:300,400,700|Roboto:300,400,700" rel="stylesheet">
+
+    <!--
+    Redoc doesn't change outer page styles
+    -->
+    <style>
+      body {
+        margin: 0;
+        padding: 0;
+      }
+    </style>
+  </head>
+  <body>
+    <redoc spec-url='http://petstore.swagger.io/v2/swagger.json'></redoc>
+    <script src="https://cdn.jsdelivr.net/npm/redoc@latest/bundles/redoc.standalone.js"> </script>
+  </body>
+</html>
+
+```
+
 For step-by-step instructions for how to get started using Redoc
 to render your OpenAPI definition, refer to the 
-[Redoc quickstart guide](https://redoc.ly/docs/redoc/quickstart/intro/).
+[**Redoc quickstart guide**](https://redoc.ly/docs/redoc/quickstart/intro/).
 
-[**IE11 Support Notes**](docs/usage-with-ie11.md)
+See [**IE11 Support Notes**](docs/usage-with-ie11.md) for information on 
 
 ## ReDoc CLI
 For more information on Redoc's commmand-line interface, refer to
-[Using the Redoc CLI](https://redoc.ly/docs/redoc/quickstart/cli/).
+[**Using the Redoc CLI**](https://redoc.ly/docs/redoc/quickstart/cli/).
 
 ## Configuration
 

From 899d7f9637815619d708ef8cfd1078b6339bfe61 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Mon, 13 Sep 2021 07:22:18 -0400
Subject: [PATCH 28/43] Adds some notes to deployment

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 9ed57fa8..5647e2fd 100644
--- a/README.md
+++ b/README.md
@@ -100,6 +100,9 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
 
 ### TL;DR final code example
 
+To render your OpenAPI definition using Redoc, use the following HTML code sample and
+replace the `spec-url` attribute with the url or local file address to your definition.
+
 ```html
 <!DOCTYPE html>
 <html>
@@ -133,6 +136,7 @@ to render your OpenAPI definition, refer to the
 [**Redoc quickstart guide**](https://redoc.ly/docs/redoc/quickstart/intro/).
 
 See [**IE11 Support Notes**](docs/usage-with-ie11.md) for information on 
+IE support for Redoc.
 
 ## ReDoc CLI
 For more information on Redoc's commmand-line interface, refer to

From bd9390a5bfc5458c06121110db33968a20fcebe4 Mon Sep 17 00:00:00 2001
From: Mark Theisen <mark.theisen@spothero.com>
Date: Tue, 14 Sep 2021 05:08:50 -0500
Subject: [PATCH 29/43] feat: new option generatedPayloadSamplesMaxDepth
 (#1642)

---
 README.md                              |  1 +
 src/services/RedocNormalizedOptions.ts | 16 ++++++++++++++++
 src/services/models/MediaType.ts       |  4 +++-
 3 files changed, 20 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 855dac49..2bbdc134 100644
--- a/README.md
+++ b/README.md
@@ -105,6 +105,7 @@ You can use all of the following options with the standalone version of the <red
 * `disableSearch` - disable search indexing and search box.
 * `expandDefaultServerVariables` - enable expanding default server variables, default `false`.
 * `expandResponses` - specify which responses to expand by default by response codes. Values should be passed as comma-separated list without spaces e.g. `expandResponses="200,201"`. Special value `"all"` expands all responses by default. Be careful: this option can slow-down documentation rendering time.
+* `generatedPayloadSamplesMaxDepth` - set the maximum render depth for JSON payload samples (responses and request body). The default value is `10`.
 * `maxDisplayedEnumValues` - display only specified number of enum values. hide rest values under spoiler.
 * `hideDownloadButton` - do not show "Download" spec button. **THIS DOESN'T MAKE YOUR SPEC PRIVATE**, it just hides the button.
 * `hideHostname` - if set, the protocol and hostname is not shown in the operation definition.
diff --git a/src/services/RedocNormalizedOptions.ts b/src/services/RedocNormalizedOptions.ts
index c2407b97..be1df279 100644
--- a/src/services/RedocNormalizedOptions.ts
+++ b/src/services/RedocNormalizedOptions.ts
@@ -42,6 +42,7 @@ export interface RedocRawOptions {
   maxDisplayedEnumValues?: number;
   ignoreNamedSchemas?: string[] | string;
   hideSchemaPattern?: boolean;
+  generatedPayloadSamplesMaxDepth?: number;
 }
 
 export function argValueToBoolean(val?: string | boolean, defaultValue?: boolean): boolean {
@@ -163,6 +164,16 @@ export class RedocNormalizedOptions {
     return 2;
   }
 
+  private static normalizeGeneratedPayloadSamplesMaxDepth(
+    value?: number | string | undefined,
+  ): number {
+    if (!isNaN(Number(value))) {
+      return Math.max(0, Number(value));
+    }
+
+    return 10;
+  }
+
   theme: ResolvedThemeInterface;
   scrollYOffset: () => number;
   hideHostname: boolean;
@@ -196,6 +207,7 @@ export class RedocNormalizedOptions {
 
   ignoreNamedSchemas: Set<string>;
   hideSchemaPattern: boolean;
+  generatedPayloadSamplesMaxDepth: number;
 
   constructor(raw: RedocRawOptions, defaults: RedocRawOptions = {}) {
     raw = { ...defaults, ...raw };
@@ -257,5 +269,9 @@ export class RedocNormalizedOptions {
       : raw.ignoreNamedSchemas?.split(',').map((s) => s.trim());
     this.ignoreNamedSchemas = new Set(ignoreNamedSchemas);
     this.hideSchemaPattern = argValueToBoolean(raw.hideSchemaPattern);
+    this.generatedPayloadSamplesMaxDepth =
+      RedocNormalizedOptions.normalizeGeneratedPayloadSamplesMaxDepth(
+        raw.generatedPayloadSamplesMaxDepth,
+      );
   }
 }
diff --git a/src/services/models/MediaType.ts b/src/services/models/MediaType.ts
index 8987fbbb..9e41d89a 100644
--- a/src/services/models/MediaType.ts
+++ b/src/services/models/MediaType.ts
@@ -14,6 +14,7 @@ export class MediaTypeModel {
   name: string;
   isRequestType: boolean;
   onlyRequiredInSamples: boolean;
+  generatedPayloadSamplesMaxDepth: number;
 
   /**
    * @param isRequestType needed to know if skipe RO/RW fields in objects
@@ -29,6 +30,7 @@ export class MediaTypeModel {
     this.isRequestType = isRequestType;
     this.schema = info.schema && new SchemaModel(parser, info.schema, '', options);
     this.onlyRequiredInSamples = options.onlyRequiredInSamples;
+    this.generatedPayloadSamplesMaxDepth = options.generatedPayloadSamplesMaxDepth;
     if (info.examples !== undefined) {
       this.examples = mapValues(
         info.examples,
@@ -53,7 +55,7 @@ export class MediaTypeModel {
       skipReadOnly: this.isRequestType,
       skipWriteOnly: !this.isRequestType,
       skipNonRequired: this.isRequestType && this.onlyRequiredInSamples,
-      maxSampleDepth: 10,
+      maxSampleDepth: this.generatedPayloadSamplesMaxDepth,
     };
     if (this.schema && this.schema.oneOf) {
       this.examples = {};

From 3f6bf5febbd61f5ab99b5efb50006465110f3f5d Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Mon, 20 Sep 2021 14:08:58 +0300
Subject: [PATCH 30/43] chore: update libs (#1707)

---
 package-lock.json | 74 ++++++++++++++++++++++++++++-------------------
 package.json      |  4 +--
 2 files changed, 47 insertions(+), 31 deletions(-)

diff --git a/package-lock.json b/package-lock.json
index 73cfe473..41b9dcc2 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -9,9 +9,8 @@
       "license": "MIT",
       "dependencies": {
         "@babel/runtime": "^7.14.0",
-        "@redocly/openapi-core": "^1.0.0-beta.50",
+        "@redocly/openapi-core": "^1.0.0-beta.54",
         "@redocly/react-dropdown-aria": "^2.0.11",
-        "@types/node": "^15.6.1",
         "classnames": "^2.3.1",
         "decko": "^1.2.0",
         "dompurify": "^2.2.8",
@@ -59,6 +58,7 @@
         "@types/lunr": "^2.3.3",
         "@types/mark.js": "^8.11.5",
         "@types/marked": "^1.1.0",
+        "@types/node": "^15.6.1",
         "@types/prismjs": "^1.16.5",
         "@types/prop-types": "^15.7.3",
         "@types/react": "^17.0.8",
@@ -2672,13 +2672,13 @@
       }
     },
     "node_modules/@redocly/ajv": {
-      "version": "6.12.4",
-      "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-6.12.4.tgz",
-      "integrity": "sha512-RB6vWO78v6c+SW/3bZh+XZMr4nGdJKAiPGsBALuUZnLuCiQ7aXCT1AuFHqnfS2gyXbEUEj+kw8p4ux8KdAfs3A==",
+      "version": "8.6.2",
+      "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.6.2.tgz",
+      "integrity": "sha512-tU8fQs0D76ZKhJ2cWtnfQthWqiZgGBx0gH0+5D8JvaBEBaqA8foPPBt3Nonwr3ygyv5xrw2IzKWgIY86BlGs+w==",
       "dependencies": {
         "fast-deep-equal": "^3.1.1",
-        "fast-json-stable-stringify": "^2.0.0",
-        "json-schema-traverse": "^0.4.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2",
         "uri-js": "^4.2.2"
       },
       "funding": {
@@ -2686,12 +2686,17 @@
         "url": "https://github.com/sponsors/epoberezkin"
       }
     },
+    "node_modules/@redocly/ajv/node_modules/json-schema-traverse": {
+      "version": "1.0.0",
+      "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+      "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="
+    },
     "node_modules/@redocly/openapi-core": {
-      "version": "1.0.0-beta.50",
-      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.0.0-beta.50.tgz",
-      "integrity": "sha512-GuXn4IETxpbRd8dlAQDQPtvqOpbMvPMeC/e5mv5MOXkLIznNk4vjiQVe6QSCbZbCHzzpb2+89B6S7asebPm4Rg==",
+      "version": "1.0.0-beta.54",
+      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.0.0-beta.54.tgz",
+      "integrity": "sha512-uYs0N1Trjkh7u8IMIuCU2VxCXhMyGWSZUkP/WNdTR1OgBUtvNdF9C32zoQV+hyCIH4gVu42ROHkjisy333ZX+w==",
       "dependencies": {
-        "@redocly/ajv": "^6.12.3",
+        "@redocly/ajv": "^8.6.2",
         "@types/node": "^14.11.8",
         "colorette": "^1.2.0",
         "js-levenshtein": "^1.1.6",
@@ -3038,7 +3043,8 @@
     "node_modules/@types/node": {
       "version": "15.12.2",
       "resolved": "https://registry.npmjs.org/@types/node/-/node-15.12.2.tgz",
-      "integrity": "sha512-zjQ69G564OCIWIOHSXyQEEDpdpGl+G348RAKY0XXy9Z5kU9Vzv1GMNnkar/ZJ8dzXB3COzD9Mo9NtRZ4xfgUww=="
+      "integrity": "sha512-zjQ69G564OCIWIOHSXyQEEDpdpGl+G348RAKY0XXy9Z5kU9Vzv1GMNnkar/ZJ8dzXB3COzD9Mo9NtRZ4xfgUww==",
+      "dev": true
     },
     "node_modules/@types/normalize-package-data": {
       "version": "2.4.0",
@@ -8358,7 +8364,8 @@
     "node_modules/fast-json-stable-stringify": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
-      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw=="
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+      "dev": true
     },
     "node_modules/fast-levenshtein": {
       "version": "2.0.6",
@@ -13267,7 +13274,8 @@
     "node_modules/json-schema-traverse": {
       "version": "0.4.1",
       "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
-      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg=="
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true
     },
     "node_modules/json-stable-stringify-without-jsonify": {
       "version": "1.0.1",
@@ -16757,7 +16765,6 @@
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
       "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
-      "dev": true,
       "engines": {
         "node": ">=0.10.0"
       }
@@ -22961,22 +22968,29 @@
       }
     },
     "@redocly/ajv": {
-      "version": "6.12.4",
-      "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-6.12.4.tgz",
-      "integrity": "sha512-RB6vWO78v6c+SW/3bZh+XZMr4nGdJKAiPGsBALuUZnLuCiQ7aXCT1AuFHqnfS2gyXbEUEj+kw8p4ux8KdAfs3A==",
+      "version": "8.6.2",
+      "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.6.2.tgz",
+      "integrity": "sha512-tU8fQs0D76ZKhJ2cWtnfQthWqiZgGBx0gH0+5D8JvaBEBaqA8foPPBt3Nonwr3ygyv5xrw2IzKWgIY86BlGs+w==",
       "requires": {
         "fast-deep-equal": "^3.1.1",
-        "fast-json-stable-stringify": "^2.0.0",
-        "json-schema-traverse": "^0.4.1",
+        "json-schema-traverse": "^1.0.0",
+        "require-from-string": "^2.0.2",
         "uri-js": "^4.2.2"
+      },
+      "dependencies": {
+        "json-schema-traverse": {
+          "version": "1.0.0",
+          "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz",
+          "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug=="
+        }
       }
     },
     "@redocly/openapi-core": {
-      "version": "1.0.0-beta.50",
-      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.0.0-beta.50.tgz",
-      "integrity": "sha512-GuXn4IETxpbRd8dlAQDQPtvqOpbMvPMeC/e5mv5MOXkLIznNk4vjiQVe6QSCbZbCHzzpb2+89B6S7asebPm4Rg==",
+      "version": "1.0.0-beta.54",
+      "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.0.0-beta.54.tgz",
+      "integrity": "sha512-uYs0N1Trjkh7u8IMIuCU2VxCXhMyGWSZUkP/WNdTR1OgBUtvNdF9C32zoQV+hyCIH4gVu42ROHkjisy333ZX+w==",
       "requires": {
-        "@redocly/ajv": "^6.12.3",
+        "@redocly/ajv": "^8.6.2",
         "@types/node": "^14.11.8",
         "colorette": "^1.2.0",
         "js-levenshtein": "^1.1.6",
@@ -23312,7 +23326,8 @@
     "@types/node": {
       "version": "15.12.2",
       "resolved": "https://registry.npmjs.org/@types/node/-/node-15.12.2.tgz",
-      "integrity": "sha512-zjQ69G564OCIWIOHSXyQEEDpdpGl+G348RAKY0XXy9Z5kU9Vzv1GMNnkar/ZJ8dzXB3COzD9Mo9NtRZ4xfgUww=="
+      "integrity": "sha512-zjQ69G564OCIWIOHSXyQEEDpdpGl+G348RAKY0XXy9Z5kU9Vzv1GMNnkar/ZJ8dzXB3COzD9Mo9NtRZ4xfgUww==",
+      "dev": true
     },
     "@types/normalize-package-data": {
       "version": "2.4.0",
@@ -27480,7 +27495,8 @@
     "fast-json-stable-stringify": {
       "version": "2.1.0",
       "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",
-      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw=="
+      "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==",
+      "dev": true
     },
     "fast-levenshtein": {
       "version": "2.0.6",
@@ -31180,7 +31196,8 @@
     "json-schema-traverse": {
       "version": "0.4.1",
       "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz",
-      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg=="
+      "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==",
+      "dev": true
     },
     "json-stable-stringify-without-jsonify": {
       "version": "1.0.1",
@@ -33869,8 +33886,7 @@
     "require-from-string": {
       "version": "2.0.2",
       "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz",
-      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==",
-      "dev": true
+      "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw=="
     },
     "require-main-filename": {
       "version": "2.0.0",
diff --git a/package.json b/package.json
index 6f57959e..b4fb9912 100644
--- a/package.json
+++ b/package.json
@@ -79,6 +79,7 @@
     "@types/json-pointer": "^1.0.30",
     "@types/lodash": "^4.14.170",
     "@types/lunr": "^2.3.3",
+    "@types/node": "^15.6.1",
     "@types/mark.js": "^8.11.5",
     "@types/marked": "^1.1.0",
     "@types/prismjs": "^1.16.5",
@@ -146,9 +147,8 @@
   },
   "dependencies": {
     "@babel/runtime": "^7.14.0",
-    "@redocly/openapi-core": "^1.0.0-beta.50",
+    "@redocly/openapi-core": "^1.0.0-beta.54",
     "@redocly/react-dropdown-aria": "^2.0.11",
-    "@types/node": "^15.6.1",
     "classnames": "^2.3.1",
     "decko": "^1.2.0",
     "dompurify": "^2.2.8",

From c87600d520f037d291169b44b5803a35af16b5a5 Mon Sep 17 00:00:00 2001
From: Ivana Isadora Devcic <33730345+skadinna@users.noreply.github.com>
Date: Tue, 21 Sep 2021 22:17:48 +0200
Subject: [PATCH 31/43] fix: Redoc spelling

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 5647e2fd..7205e4f7 100644
--- a/README.md
+++ b/README.md
@@ -22,7 +22,7 @@ examples.
 
 ## Live demo
 
-If you want to see how ReDoc will render your OpenAPI definition,
+If you want to see how Redoc will render your OpenAPI definition,
 you can try it out online at https://redocly.github.io/redoc/.
 
 A version of the Swagger Petstore API is displayed by default.
@@ -138,7 +138,7 @@ to render your OpenAPI definition, refer to the
 See [**IE11 Support Notes**](docs/usage-with-ie11.md) for information on 
 IE support for Redoc.
 
-## ReDoc CLI
+## Redoc CLI
 For more information on Redoc's commmand-line interface, refer to
 [**Using the Redoc CLI**](https://redoc.ly/docs/redoc/quickstart/cli/).
 

From 669adddc9dc3590df997b234e274b849c708d715 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Wed, 22 Sep 2021 22:17:19 -0400
Subject: [PATCH 32/43] Updates per reviews and adds new logo

---
 README.md             |  13 ++++++++-----
 docs/images/redoc.png | Bin 0 -> 8047 bytes
 2 files changed, 8 insertions(+), 5 deletions(-)
 create mode 100644 docs/images/redoc.png

diff --git a/README.md b/README.md
index 5647e2fd..7f55d8af 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 <div align="center">
-  <img alt="ReDoc logo" src="https://raw.githubusercontent.com/Redocly/redoc/master/docs/images/redoc-logo.png" width="400px" />
+  <img alt="ReDoc logo" src="/docs/images/redoc.png" width="400px" />
 
   # Generate interactive API documentation from OpenAPI definitions
 
@@ -13,10 +13,13 @@
 
 ## About Redoc
 
-Redoc is an open-source tool for generating OpenAPI(aka Swagger) definitions. By default
-Redoc offers a three-panel, responsive layout: the left panel contains a search bar and navigation menu,
-the central panel contains the documentation, and the right panel contains request and response
-examples. 
+Redoc is an open-source tool for generating documentation from OpenAPI (fka Swagger) definitions. 
+
+By default Redoc offers a three-panel, responsive layout: 
+
+- The left panel contains a search bar and navigation menu.
+- The central panel contains the documentation.
+- The right panel contains request and response examples.
 
 ![ReDoc demo](https://raw.githubusercontent.com/Redocly/redoc/master/demo/redoc-demo.png)
 
diff --git a/docs/images/redoc.png b/docs/images/redoc.png
new file mode 100644
index 0000000000000000000000000000000000000000..15579760928b664b526cc89aedceecfb72460154
GIT binary patch
literal 8047
zcmeHs_g52L)HMmAiwPa1#n6O+(gc(iFi3CGJE%12N|hEsARxUXQlytqLN^rYC?Hju
zBGQYYgMfhWhUfbaz8~N9t~D!b&dfb??>*<to|C<!bhMPIDQ{5{5fM?Vsvw^b5djhi
z=f&itgx@3l>}Mh(P6<_{g1#?cJ3A_!;r{o&b?x^o{kyN+AAy*dO;R*X3LR%p0w+jk
z6>d2sC?V(}5QUC31BACjo=KLSW9N|Hiy<sV>q(jZWLuMf_VCA&ok}xRo==4b`i+vo
zbe`M@;PtV9Sa7=;v=I(cL0umpk~iW1ov3s~5s~yzu*xP9Q6vyi=pc+q|KEuB<T{A=
zHDh$wR}+Xx-q`-%@c-Y)q*x+2>SgJFc<<2BmE5CmJBz2i*M8Z4>YqMebn3Y&r_ws%
zR>=HB-a;d*P9O8L`4OAkYsGq5XCHwZN672!sgkD{BC49^C<P{&EVqp)u`00FSH2(P
zH)P#ojGH~P9po<G`d(i6C5d)AsS@(k5slacfl^lo`h=FOs{it_Jxts@+kx!QE;THT
zr{WF6Lz%AAjiL^DLZRY+&LvVGg!2))neARW4CcJA$9B0{s5!fE|GI9hxpi&<LVS<d
zWzv>x9<+<OpK^O_t(ZJpT*&?JHcW>SpwPrXnq=TMCu5%@EFAPA%%LrCTL1AW=XL4a
zp-53g7-D9f>A^PyrsH$r-T^IE=I!G!VKKbTd4XcEYvVjcpLkrh6j%G%>uLw%TEiG-
zF|*dA$H81wsd<+zKTyycwiJu1v`_%;DCABn%Dm0HTgrOgXHUvw=fYO=V9@7mwr+i?
zr|cCl|7_>{PgKwIqn^L{m9cuLK_h_-813gs#3Bg@&#CV=DP<&YljD1E<S4g7N&9<K
zjHw4h0`GZS9h|pHzjorC`*0s04kuA%FHi+?>u3VQ857RI9MOcBS74aO4)!c$x=8TD
zKhN`RHXl~ptxCsHL*zMRIgW>SuVXP9h4?@M3cOluvj5Bej6=@L%xl1)J8DY$1VlQ_
z1OK_7TYbdP(k|^l9u-Uo|EX5qC{Q%$9S(+JmFzzWh}FCrThq%w_wSBX1l}%2_vEjT
za4!gjC{n46faP=zQ8j@|Oxi@mYq=U3CC~4e@j?;<$>RFR`rw2Ywv|iA0Wik$xYd2L
z+=pfJ-NLWnD+_T67bXZL|E;m*E3bcu_h+lEc%hAWkV;-5h*AhT7Oi#J9{j1Ya5mMd
z_LxHorV+tsqfJG;{~u&PDN>#wT<2PaCi<TNfn;D#vFOhWG<uG+k^pT>HJ~k@jvByG
z&KtM&H_hzqCff@MZ~Mv@b4fqiScEAO5Lj}8H=~f56~??2JL5Xvs4UG9>Ls~;?`2F`
zUv13T?T~WFog!50*sIcwjnhg2#NbQ43CgR>M|_kw+9$4qqnVci4DIyvZYYG$#OKN|
z>{2sVx<m!E;m<uK^W12mAzgHLDpA%v_a(K|jO0eFT45c!!>&}Ezqamc$OL{*+#x;E
zB;?QmSi}I)_ZEgWJMDf@wAX3i0-u}MERqNRs#(o?p&Wn02cRv5g*>4`W48J<ETO~i
zTa1;4dfWaK^lKxVEW1-+K)pM{oZ89+1my$V10g9X1X?L3n4-0rBuUS0tw(PB0H0k1
zpKoWT7d^+v?WO>MRsP5SHhAcGO+nHo`3&V}qZwtKJUwtgqT<r)fUAQ2u6~0Zh}Mv^
zo(HSMi(*b~O1;^rjuF1$JA<GBiWW)fMS)ccN)@KVoW(J<x|0qO%V?E};_UAOz#sUv
z)t&jad)6k<3UH&?&c?z*Fymh(z?aac*lt2JuaU%TR*9r@wJ9Dpeq3YG;<b0CDgDZy
zGUA)|2+zHiV>SUf4l#9%^BnB1WqXd<#UPt7N#W2(r}V}rl%E^$lD#p0gE71h%-?Wr
z^()h`NUw_7+Ft7Z6mJ<{b2qRA(hjQ!DBpS)f3*a86x^nRxcKUyc|h>&K2}yZt7@2|
zrB<J!#F(HBnN2Q^HIeP|Gnf^018h53IGqGu@vI1hOpBb&tvd3qMUKl9ptyMq+wtl`
zP|+4^@8y9>My&ttZEUe)mND*Z(3+Rg?pbeOM9lkQjJR$1axz*b=mOb77HH{TYGjH?
zsBT_QF44B#U(|hs0_Fpj#~km0xHW^Gl8%=~9rDA15pPs|_;VJQYbUeDt*6c^BT!I_
znX<&=_WD`c3k874;r^l(C0gmO9`f={z31fPB2-@2*KPxK1QdpEzjzqWoyx00sp42W
z{@^w}MBS4<@hYV2a$_+q^5W7kmnMxn*}{%C!A1InLjS3%+>9ShWzp3Q<|2(q4RGAd
zz{#4Bt5)%#2qii$Mt+?iN^$TG1_K>ufsJYpq)EpQg`J+#CRp7wS55E_ZlnLHXRLIk
z7T-B=^x3l$Bb)t>hy?kyx1^3f;mybG7PNJ4YH;hEvdL!Se0x@c-NmXO1-kWc6)v>Y
z&?K*4Oa=?3uHTvWhu&KkL85@Pp^KYFl;}r&=XYV%?L}4YBbTqggcQ%J&jUkSo{?rc
zdz8j$W;uEpr>fIK7#Kbc>mt|=f7sJ>`bL)LD}^UDRJ=h!hq?NO42vl?*^a-&V3G}@
z_wGQ8KKJQI<)I2Y)+^A2Z-JJ{EXTu_G9;P}(`poG*Ox?~m8+IxrjgtU=RonuJ5XKN
z<-cN7;m|8iC6Hm1flvZx(8U9uufy|j9_UP$kz`|7y=9ws!K)P+`A2~LRwDA-cc3gO
zfM3YM-36=~fd3^EW3)o9!f#InM6>M6b+T~acxIHFJz>ylvo>tJpy~CEm7~l<maz-5
z47CP?yYht8XP<NM6$^h56`^l2h7d-k0j!W9|F0Fe8f!N}CnHq=i>zaasD%pLyHMkI
zj;ueg*1wl>Gv<!2-M>3zD96LV8eg<?8jJ<4>P+(R;I#wz=66onn|8UK@Be+9RR`{;
zcyu$4Qpvf|&qN(Wf56{$1AO#c#dSQ@Wk#~gHz?fr7skHy!1cF%2)lI8{zY#EgQWDU
z-AiJ?a=vj&bU@Ew<jVEOC!@hS++nUpwr0=VuH^-NLQL-W+PCB!Y^lBrY<)Df-oAId
zPSooXbQnf(*t1My;T}i4&W8`cD6>LlEvBigg-b}XjEg(FiyXs@_xZHbzk2iT{jL+A
z^H_Q($(@bo9uL5PPSgBexFovie9ELB?9t;rNv%E|m6lc6IGb{cE76wjId(gK3&t1U
z>L1L%*y{?ftdAGZ)d(0dJwX7z+>RU&g!vZ4$w5zJ2SmYyu#IWnM4a8^l%>gPO=GPD
zy6p<csSex3Y_4p+!k(zV?96<{)Qhr7e$q=#b$1Mwa917Bsg-!hST$wp-?$nX1(~5D
zmo~9m6($A?Wl#TNNs8ti7bbKO`-8JoCQ6mR7j+OX2Y_ZY{NDxEzy9!sbHZep{hHM%
z$QwT@!4XEfAEbL%bg)lx)x*K#ho$7{!C3x3M>hIF6}OtWUq6d`i!aQ~CG#(S&I66S
z$w^n;cBpH&1-VLZ0n?hqm|3`e<RJ}|c`(s@+l{GuCgGu*<|_8dl`i5Xw+k0+_lTAM
zKp2o@R9ie^Q5=x57SJe=Zf2;4sEJTA^2l#dwqK`WIJ!`>a`^YVt6ny~3Y@~lL>9~p
zuW2(%!V6n|3)rfc*rGPuGTfDvaG8!s<d(xZjj^wN=Q*9gPJ}=<yR`f{maUaIIrj<A
zyiNNq|7}`j{7)4D*8={FPtR8$hcxl&0fe&98+O(qP8?NFfKR_4l4M1fu^m|Ol{&)H
zYl3e;`7Az@cUEx9OHL2W(znN=7KCKp54W~2ul60qlph>-#LK^BvTWewdl`E^^Ch?3
z)hgrFJo)E;WZ>SG-Rbow*2{v8ibx%b3`!FkQ<$(!sd|`Wqt?5U546D0wo$LmF25Vl
z3O2iijEgT<!i}}=n-8)0maxv(v~zB|C(5Atb`f`1vAlnO4|ome>(_<x>hr(W&@Q=T
z@foy3+_$6xUjDvYBn6mlUj2dG$4@yKkEXskK>0o$o#VAQxHaTm=hd&Bt;x-C&x;kB
z(2r)7BQ(FF-jM@RHu*$3WiV+s5U7$Q)5DK#nN)V4^nu^ndY{xc96A6SlqGuUc4_bH
zI)WfT7sFa{r*1~sr@(c~lA{m)-SscoZJn2n!n^E>Xa1eLJRLhIo>5!h7%6$!`^XFE
zpEHx<abv1rwUjloJBF8BfzUr;DenbnC!?%k5ss~@5n*b7E2>Wf{&M}yph27HG6yFI
zX((s8q<7{!jeNi^cIMr|^(TBPpQ7&jmS8opCa4=tGjN~xCjC!8E@<(C%VI_Qb1Pr(
z=qeq03*>7@fuzjCbbQkLvj9tAXyoM&S+ZWZTjmLI=dGyHM{jBM%)D$12D6C6Hk);W
zJwA!(QM!G{xsQeRwQ25*E%RX+pz|3%0q1SCOM2n4JHq5&KebSg_6gmx&qhHp^Tf)m
z-JPh1q#Xtfbpk<BO;-!r*v-ckJg((`dsyDacyy~17gIfBkF9K(dI=Z)%+K;Qqe(`B
z)1|xW*lV6#rNIm;TJTl?=3w)M4Enm~duZ!>RRr{V21UwBSQVEi*{r91`{~*FfEP(t
z)Am>`Vm06_=3M-%)3h69_QwGCcz<1!2JZ?9*S+{EfoWGd{WlWQ50>N}0zx24gW9K(
zrtCg!B@0h~-@S<JejC&uBc2_`6Tb0h@z-ZFqp%OYJGW(QfAG$-0?O8yRq8t!b&-8q
zx+7}}C*bkqbTJB*)5YQCmftr0X4tYniO)Mf#If+&ZH!O&FED3IhJ0<;_~`-RMI&xS
z?nqdui?i9MqI$61GYV#AIEKI5+wn0lGE!qm>C5Yecr|W2cA}NJbjK)yQ2*qj>cd^8
zSi8E<zv(2Y)Qwc4xnaKWsXr%t>~oX*quJGIsF)lntJ(0Uuhswg9tm2A(&kEjbsw)(
z?G!k6=i&I5liKh+1EYW!ycKlXq=wMg66OuvPO5Wfo)+!ZZjb{l^W#M0JU<M^SBU|t
zL4~glD*TJ@!1B%1QGm6qN}reE#?$~7LVM>ObUAKt_JujaA~iMa&oB3Iw##-cG5C!&
zy{_r-PtO{S((YEN8}mRj<T&H>PR~O}rk}I4Sw{y-UF`Y9yh3J|IcZA9O5ciz|HKb9
z82)3*L^Cl%_J+refXgA!{G>1%WOnz?o5cZ@AmwS@Bn2yr(*v2VaWCZ$(z>e}%XAXO
z#`-qDhiw{@9C=d-+koS2NO{#GPd82JGfE*|!st7PqOU#KPtfxPF@zcJCsZ^Dz&7-z
zzh-oHm*LgE&^q#fKwTjWzl1}X*R8<<rkx8u98_JNVq_wuG+q!{i}0vfJzm|I2-|a3
zq5BL}@AW7?tGktIwjG_jzuy+3vmnE_;ZAJ?`L;Y)*(B!o0>;Y-6vH=jfuKf4B~W9A
zCm1?EBd~Y?f!ruua`8Pbf%gvoB*UyPcW=FkBP-5%TJcLz{vlTJD(IVyyE#)+>#?V#
z*SZo(&-2~~_r#=(OFlfKWry@bKmPuXX}Qe*Yk2gFKH=6trztJX(K>$K!A5*<t?~!M
zZF^dXr_fxpU(1C36<9enH3S2dE6-XxGK>-*6fO_!QEaH`zC~;C{=l>(jK3G>|Cj_s
zyo+=4g8%E@eDya@361lAdhph>n2Fe!ym*3cPYtmmh`~79%+3rZO)t2RvyS%sNuCZx
z*Ux|C!?jmPT4YZXR|^#L0z@hg`tmSU2OWNxa_!&3E&cR%JXiiRmmBxSBu)C1ScbYk
z$l%A>7$7UDJEr<aeo~mfV?XIU(r*fSO@Cm}D&bp*MXh|ii8MOZU$>cu4IAhoh2t%o
z)*p<Ag`4^vmEbd)DaqH)vZmnHM9gm6s%)mx<ua9hAGv{{KS>VV{f{}P4pd-JE7zZ?
z%11zTVq7bhA)&RTY&~g@lJs{hsz+1$8$-R!aQ6-G_Z1Q7Jbt(GnlZ1`^f4qmST8_B
z2=az3MEEOxXl#kp1mmKwP0=fk)lQxv2d1=5>fnp|2zOD@^UGDkHie#2R0i(q;Ps%}
z_lsDGPhH-<dzj4w=&;TUJ7KC@36jA4tg(E!lwZ!Tqe<6_r6;O13WJX%l?-ZU_P2v7
zeC_>oZvhl!tZ|BcR$dySsJA=H*->soDqZcHsb@%*te)*QKtVye{Q>KizJ|wL0cgfp
z39H_q`ho`jY5qOMhs4qUBDIFz7?=?6KSsPLCrPsIG~q#l8YAVHMHS3g@)SFYRVUpY
zNkDz)ON}pk=fRCy_K&FQaOK;c(y;ucDU&%(I{W0*`BKz^+(Wu8X1BMjte#PP7_$n{
z&56d_4mOcd3^=EWcSaPyN}PYS(ImiPLy%M^IWSs#03(>eTk8>9`QkVw`BF@i=1+0W
zLhyvG%gJa?p~#nbS=sz$+SE1Mr$yzX6FuPb*A)Whep+7g_2Mg6W6!2YA86X??J3fD
zG2_vFs+WE9Jf1Ir1O!XEXK!O`O9pq8lBlcsHp?AKDKq#Fxz{({Y}3-H{#Z_ib4qja
z-Jj9k`-6wYY9g*TxY@v-tOMd@abC-7#%&~7#S!@<ZSQVo@s^E8yqc*~vPX{c4F4hR
z4r|UOAi<jAC`m?<*tT#KOQNn%p^4i=QpT9%m{g_iyN7NBMB8A=G*DkzT6F?;<yAPZ
z__dbVI2XRV3kQT)$1#ij$gs=8@+XhU9u@G-@^$qvz>D?`*|sYr|AvStX8M$Kc`FTd
zZO@(*?8`O(2cHY})ANr^klH<!#7|gUdg{V^^8{R_(w}1llach?5K0vVQMJcnv1n@y
zF`jFb4CAk};)m(z#b92vU_hYFjx)xL;snPS4s6$tJ{hW^G~~a5UmHtmKXSoWHKc;w
zps?(gU~<z@kH0jM^I`7eQkaFQOzy<}UR@q&^SxqhWHnWAe-P{Xu$2~FTZg>F5oILn
zWgPZqwphag<neb#UWxPQ9}o?uCR15$K-uJbksf#%x<iMZF}dv&_uc%_DWKa2V_uaS
znp1=#a-91irjdvwGcGW(`E5leU(aT)1oESzgOAB{y6Ml&ME+bkW*4sR>PO);)z!V?
zi6h@t_7HnaQjp`=z3Q+FU|=wTL7UuuHj*vnHGCS1+S7a{#LTxn9+;3Md$AO@b8kiW
zNu-Fx&_<}O)m({S9Pr8L`+Ay0j@>}P$8lLs0oJQwAza0!`MJ0>^C@6xeXoldr8<en
z@DVR{T8;ku`uq-4iY<QH;p7dUEgz0`PqFAO8ynM>N)q#WbNeAPyBH%W=YVMn@+G+@
zn+6d<@*7BIw=IdA&$85wf?0mla>(Bgk{w!eS;LAJx-9H{S=y>jcg|;QRk6NGtg(%3
zI*a-2yh~T1vf@ia!mZrwM@DF+$H>f1Sf^B6IHOx97;egg0gnDNu5<ou3^UpyZ)L}F
zIjiXP&9T4EetVfI;kR2BxxLQfgzT`U=91J#5wYxt&TJAyb(?mIM!dM?8cCT86)Iw>
zCCNT+XiA0+@3OVOI0gBePH__BdE&|tKdMg<=7q;O;p}~DHP9xTFW+YZw`n*?y9yY6
zyBELgIy_h^Qt#{Z?CFr-3h7L+Z8iv<k~THPOKyKN^+NbqByBE>1~qse{RiSNX1bCj
zu+H%g0?&kntKi%anr=(dVltvDn<9z%<9v9QQ&Ha9ZKw(>PE^BLXR+t&mAv<o#+IOj
zA2`Dx^Pzu~aeXWQ4E3x1XzCCOzn`Wgo7x=vQ)hW!+wsKSc^Vc<qI2TP6IH>y06=ie
zeFf{}InI1?`O<*oGxev9q<`aj(^Ypurlglh$Ldz&@VBxWrw0nw=)r`(_$LKU$y$|C
zt*Dw^%ufM>Mm*Q32=(&lLp;C~PSp;oBNFTc<Gx`#{jwOwH*!WRwIsu{SLD$wrXbay
zYcBpVo9eWY8x1OA$1(9a>7SNCAjeMB#h}Quo1!w)T*&@DPn{GY(^!d0?rC4uVBf?$
zwTA@cbmYMa$~5-ZY&u%lsKa2TDK>2l<af0Joq}S?ok}a<W2&fEGeJ}0hy4<{2Gcg_
z3O}%v1~NW@KBLX@&A)Rz*7w$8rm$atHL)mY`$oHei(9rKdTHtD8K*S3ICC;Q4eh8W
zFwwSrN!)#JDzIpvRx$f}+AoZT=8Msn@shHv_FOOryMmF%JA_#Q#F$bEO{d2`QJN${
zZL5Ygss`e_;}?C-f}SnKUK{bdlfnADsp1mLq1Iitx1r=@PWHt^Q*QkDF32-!RX&kY
zse-r63~hr_33ulmbkl6J%-ukRTS5?%Qx_!n1}#4ty&?o%V3fS#^sed(D@^h_B0m<E
znk_g%>!;o~)O|El>&ZOR`<5JpFv4aIFUPW^If`(p<1ip(MC4{mn6idPbZ(5aGfp)m
zdC|_JM;&Chn`tTWoXu0&v*g2|Kt*q{Ng>>Ynb3x3_9ODc^E6<g_xW)yPm?j@aiWx0
z5uHl<-*M*)7dxPeLP7y!`?dZKz3yll$-@HezK#_omxMi_L$ldIW?KzD{VdV49*-)Y
zj1F;R7xT>i_%J5cIzY`nK*Utx)7UEqVbTp;5Vxv~$mHwE@0AL;+vQ`;$lzxfawqvl
z=U;Tv{9LLsFIG(nb=9#dh$)o7lzX*(6%@2k5J*OEj2pi>boluGldqC>4Z9Fg3QxW7
zl*=5A2B24?>P6<;&Y_m%l3?mSzbSDSs-=k2PG4wo##7?T7cGQVx2LnaA2el8AQfqA
z9<gDWX+7#UEr;OL!Z}fuxlO@!@-vH1rszJKX~afArhaerVKRJqpe71%H7WYU{1y6T
zRbVeS0>E$AZqok__B1w{DT#=Jn{Y*y9D`2RLq=yf#fVXSlLJtyY_IF`iWH)shbD#)
zgoQT*o<~u5;4&5V<e1IwOeL=tbO)NcYVoH<7g?S|5<^6h5<x^#C~o4I3yDU{!Yv7u
zejXnJFjmL^N1i_MiTyn~Wgx?C0*#Huo?Fr2?g!DC(R`eIF+Y;um;7aez(KDd2?Txq
zkNAbIqKXHL0#-E=u+T~=o1Cz?YXz<AnnQo+|8IsTW;h2Giw^kn$MT%WkB1<uFkRo8
z+2ecBdgBwm@9RG7uvX*wd$e_=#KUV9gPiV8J!+wn(Dm0OW!iCN3PW?-A0h38j6Xc5
z9A=~1FB2E8<c4SyCI`}O&rF!{5VVq5_VtY<nvQmw>LZ<9gTTVS!K@TKREb8(gl(o?
z%MO{Lny&i5&{u!x)^w3<YObHa{rs6h!8NnD#b4hB(B6TEbWwetbdro=UC!g_+7Uco
z`tf=_CynnoE{_X9Se0tt9x(KcH5Zcw9JDUN`$Rs-wT6z>JD~fquxBvO=-9qlO>BA9
zpOC69WtOdxf72}oOaz`k@mk%f!Dl({Iwv>peVTu~pBg~;M47F;9Bw8oZ3U4>4+P$w
zVXP<6dWNYVF!X-)bYS<csfzzJ1_&=fTT;k}!XDvE^pLn2s<2q}@cU0P=60vq*C7T1
zi)bN*<UdW|tW6GNp)LX%mWL%o)U5aQJUu=4JP6x@hG>D*_@JWU(`K$DdI46x4V-4&
zH-(ad+sBQ>1ugh$?!NgiS^6L~I8+o1{?0);)Avp)@WaMraLOo)_4A4XpAOPx6#_5A
zl)<4%VEGY1USJUuL~rTufAUoVN*X|kmX<!_z7A3~;m=F!a1d|K_3Gvb#@y@}-?hr+
ztBC?Gc^!-GU+X{%S_ES_PVPS?&Iw2lsjkb7BIpcIfDgg&@jfC{A_8bhmxuDr{-+^x
z?cYo=n(GR*ughbPKmhmPx9pex^Uo$2+3bOYmm&c*O{j27dwDwTYyTaBv9q<2e7%%b
zUIbwO;d!R-wZA)|$UW?p|C8qy?h{r&Jv-7vNXGxJt%O_wb#K)74FaDh5rlLiRV6KC
Jm7;a%{{Y2!oXY?J

literal 0
HcmV?d00001


From 8d93021f17fae19a05bc6d255eb18c0338466583 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Wed, 22 Sep 2021 22:20:49 -0400
Subject: [PATCH 33/43] Minor edits

---
 README.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 93de7281..cc80f831 100644
--- a/README.md
+++ b/README.md
@@ -21,7 +21,7 @@ By default Redoc offers a three-panel, responsive layout:
 - The central panel contains the documentation.
 - The right panel contains request and response examples.
 
-![ReDoc demo](https://raw.githubusercontent.com/Redocly/redoc/master/demo/redoc-demo.png)
+![Redoc demo](https://raw.githubusercontent.com/Redocly/redoc/master/demo/redoc-demo.png)
 
 ## Live demo
 
@@ -82,7 +82,7 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
 - `latest` release: https://rebilly.github.io/ReDoc/releases/latest/redoc.min.js - it will point to latest 1.x.x release since 2.x releases are not hosted on this CDN but on unpkg.
 
 ## Version Guidance
-| ReDoc Release | OpenAPI Specification |
+| Redoc Release | OpenAPI Specification |
 |:--------------|:----------------------|
 | 2.0.0-alpha.54| 3.1, 3.0.x, 2.0       |
 | 2.0.0-alpha.x | 3.0, 2.0              |

From bccd21394ef79940c2efbe24a0d866c7af103d94 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Mon, 27 Sep 2021 12:21:59 +0300
Subject: [PATCH 34/43] fix: scrolling to the first item (#1753)

---
 e2e/integration/menu.e2e.ts | 23 +++++++++++++++++++++++
 src/services/MenuStore.ts   |  1 +
 2 files changed, 24 insertions(+)

diff --git a/e2e/integration/menu.e2e.ts b/e2e/integration/menu.e2e.ts
index e1b053d1..533fb0ea 100644
--- a/e2e/integration/menu.e2e.ts
+++ b/e2e/integration/menu.e2e.ts
@@ -25,6 +25,29 @@ describe('Menu', () => {
       .should('be.visible');
   });
 
+  it('should sync active menu items while scroll back and scroll again', () => {
+    cy.contains('h2', 'Add a new pet to the store')
+      .scrollIntoView()
+      .wait(100)
+      .get('[role=menuitem].active')
+      .children()
+      .last()
+      .should('have.text', 'Add a new pet to the store')
+      .should('be.visible');
+
+    cy.contains('h1', 'Swagger Petstore')
+      .scrollIntoView()
+      .wait(100)
+
+    cy.contains('h1', 'Introduction')
+      .scrollIntoView()
+      .wait(100)
+      .get('[role=menuitem].active')
+      .should('have.text', 'Introduction');
+
+    cy.url().should('include', '#section/Introduction');
+  });
+
   it('should update URL hash when clicking on menu items', () => {
     cy.contains('[role=menuitem].-depth1', 'pet').click({ force: true });
     cy.location('hash').should('equal', '#tag/pet');
diff --git a/src/services/MenuStore.ts b/src/services/MenuStore.ts
index ac60fee8..65f6c7c8 100644
--- a/src/services/MenuStore.ts
+++ b/src/services/MenuStore.ts
@@ -210,6 +210,7 @@ export class MenuStore {
 
     this.deactivate(this.activeItem);
     if (!item) {
+      this.activeItemIdx = -1;
       this.history.replace('', rewriteHistory);
       return;
     }

From 1c8578ea8840b9e0cc8f66eda317c6839b9c1383 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Sat, 9 Oct 2021 14:40:39 -0400
Subject: [PATCH 35/43] Adds comparison table and OpenAPI link section

---
 README.md | 58 +++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 48 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index cc80f831..5074978b 100644
--- a/README.md
+++ b/README.md
@@ -32,23 +32,53 @@ A version of the Swagger Petstore API is displayed by default.
 To test it with your own OpenAPI definition,
 enter the URL for your definition and select **TRY IT**.
 
-## Redoc vs. Redocly Reference docs
+## Redoc vs. Reference vs. Portals
 
-Redoc Community Edition is free open-source software (OSS).
-Redocly has developed extensive enhancements on top of Redoc Community Edition's open core, creating Redocly Reference Docs.
-See [Comparison Redoc CE vs. Redocly Reference Docs](https://redoc.ly/redoc-vs-reference/)
-for the main differences between the Redoc Community Edition and Redocly Reference Docs.
+Redoc is Redocly's community-edition product. Looking for something more?
+Checkout the following feature comparison of Redocly's premium products versus Redoc:
 
-## Deploy to GitHub
-[<img alt="Deploy to Github" src="http://i.imgur.com/YZmaqk3.png" height="60px">](https://github.com/Rebilly/generator-openapi-repo#generator-openapi-repo--)
+| Features                     | Redoc     | Reference | Portals     |
+|------------------------------|:---------:|:---------:|:-----------:|
+| **Specs**                    |           |           |             |
+| Swagger 2.0                  | √         | √         | √           |
+| OpenAPI 3.0                  | √         | √         | √           |
+| OpenAPI 3.1                  | √ (basic) | √         | √           |
+|                              |           |           |             |
+| **Theming**                  |           |           |             |
+| Fonts/colors                 | √         | √         | √           |
+| Extra theme options          |           | √         | √           |
+|                              |           |           |             |
+| **Performance**              |           |           |             |
+| Pagination                   |           | √         | √           |
+| Search (enhanced)            |           | √         | √           |
+| Search (server-side)         |           |           | √           |
+|                              |           |           |             |
+| **Multiple APIs**            |           |           |             |
+| Multiple versions            |           | √         | √           |
+| Multiple APIs                |           |           | √           |
+| API catalog                  |           |           | √           |
+|                              |           |           |             |
+| **Additional features**      |           |           |             |
+| Try-it console               |           | √         | √           |
+| Automated code samples       |           | √         | √           |
+| Deep links                   |           | √         | √           |
+| More SEO control             |           |           | √           |
+| Contextual docs              |           |           | √           |
+| Landing pages                |           |           | √           |
+| React hooks for more control |           |           | √           |
+| Personalization              |           |           | √           |
+| Analytics integrations       |           |           | √           |
+| Feedback                     |           |           | Coming Soon |
 
-## Redoc as a service
-[<img alt="Redoc as a service" src="http://i.imgur.com/edqdCv6.png" height="60px">](https://redoc.ly/workflows)
+Refer to the Redocly's documentation for more information on these products:
+
+- [Portals](https://redoc.ly/docs/developer-portal/introduction/)
+- [Reference](https://redoc.ly/docs/api-reference-docs/getting-started/)
+- [Redoc](https://redoc.ly/docs/redoc/quickstart/intro/)
 
 ## Features
 - Responsive three-panel design with menu/scrolling synchronization
 - [Multiple deployment options](https://redoc.ly/docs/redoc/quickstart/intro/)
-- Deep linking support
 - [Server-side rendering (SSR) ready](https://redoc.ly/docs/redoc/quickstart/cli/#redoc-cli-commands)
 - Ability to integrate your API introduction into the side menu
 - [Simple integration with `create-react-app`](https://redoc.ly/docs/redoc/quickstart/react/)
@@ -99,6 +129,14 @@ Additionally, all the 1.x releases are hosted on our GitHub Pages-based CDN **(d
 - [APIs.guru](https://apis.guru/api-doc/)
 - [BoxKnight](https://www.docs.boxknight.com/)
 
+## Lint OpenAPI definitions
+
+Redocly's OpenAPI CLI is an open source command-line tool that you can use to lint
+your OpenAPI definition. Linting helps you to catch errors and inconsistencies in your
+OpenAPI definition before publishing. 
+
+Refer to [Lint configuration](https://redoc.ly/docs/cli/guides/lint/) in the OpenAPI documentation for more information.
+
 ## Deployment
 
 ### TL;DR final code example

From 3cc6ea458973f7d8bb95e43687808c4743ebce39 Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Sat, 9 Oct 2021 14:44:37 -0400
Subject: [PATCH 36/43] Minor edit

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 5074978b..82f09b27 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 <div align="center">
-  <img alt="ReDoc logo" src="/docs/images/redoc.png" width="400px" />
+  <img alt="Redoc logo" src="/docs/images/redoc.png" width="400px" />
 
   # Generate interactive API documentation from OpenAPI definitions
 

From c4564de324d78c86e4436cf7ee0aa5b8c63f48ca Mon Sep 17 00:00:00 2001
From: Heather Cloward <heathercloward@gmail.com>
Date: Sat, 9 Oct 2021 14:46:36 -0400
Subject: [PATCH 37/43] Updates image src

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 82f09b27..3aad1e42 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,5 @@
 <div align="center">
-  <img alt="Redoc logo" src="/docs/images/redoc.png" width="400px" />
+  <img alt="Redoc logo" src="https://raw.githubusercontent.com/Redocly/redoc/master//docs/images/redoc.png" width="400px" />
 
   # Generate interactive API documentation from OpenAPI definitions
 

From 35f77878de7d1dd250040771f17757a5a6ce85f9 Mon Sep 17 00:00:00 2001
From: Roman Marshevskyy <roman.marshevskyy@redoc.ly>
Date: Mon, 11 Oct 2021 10:53:28 +0300
Subject: [PATCH 38/43] fix: OpenAPI 3.1: Missing description when $ref used
 #1727

---
 src/services/OpenAPIParser.ts                 | 12 ++++++
 src/services/__tests__/OpenAPIParser.test.ts  | 14 +++++++
 .../__snapshots__/OpenAPIParser.test.ts.snap  |  7 ++++
 .../fixtures/siblingRefDescription.json       | 39 +++++++++++++++++++
 src/services/models/Schema.ts                 |  2 +-
 5 files changed, 73 insertions(+), 1 deletion(-)
 create mode 100644 src/services/__tests__/fixtures/siblingRefDescription.json

diff --git a/src/services/OpenAPIParser.ts b/src/services/OpenAPIParser.ts
index 11a001aa..1683e927 100644
--- a/src/services/OpenAPIParser.ts
+++ b/src/services/OpenAPIParser.ts
@@ -174,6 +174,18 @@ export class OpenAPIParser {
     return obj;
   }
 
+  shallowDeref<T extends unknown>(obj: OpenAPIRef | T): T {
+    if (this.isRef(obj)) {
+      const schemaName = getDefinitionName(obj.$ref);
+      if (schemaName && this.options.ignoreNamedSchemas.has(schemaName)) {
+        return { type: 'object', title: schemaName } as T;
+      }
+      const resolved = this.byRef<T>(obj.$ref);
+      return this.allowMergeRefs ? this.mergeRefs(obj, resolved, false) : (resolved as T);
+    }
+    return obj;
+  }
+
   mergeRefs(ref, resolved, mergeAsAllOf: boolean) {
     // eslint-disable-next-line @typescript-eslint/no-unused-vars
     const { $ref, ...rest } = ref;
diff --git a/src/services/__tests__/OpenAPIParser.test.ts b/src/services/__tests__/OpenAPIParser.test.ts
index b79f61b4..b8b211ba 100644
--- a/src/services/__tests__/OpenAPIParser.test.ts
+++ b/src/services/__tests__/OpenAPIParser.test.ts
@@ -1,5 +1,6 @@
 import { OpenAPIParser } from '../OpenAPIParser';
 import { RedocNormalizedOptions } from '../RedocNormalizedOptions';
+import { OpenAPIParameter, Referenced } from '../../types';
 
 const opts = new RedocNormalizedOptions({});
 
@@ -13,5 +14,18 @@ describe('Models', () => {
       parser = new OpenAPIParser(spec, undefined, opts);
       expect(parser.mergeAllOf(spec.components.schemas.test)).toMatchSnapshot();
     });
+
+    test('should override description from $ref of the referenced component, when sibling description exists ', () => {
+      // eslint-disable-next-line @typescript-eslint/no-var-requires
+      const spec = require('./fixtures/siblingRefDescription.json');
+      parser = new OpenAPIParser(spec, undefined, opts);
+      const schemaOrRef: Referenced<OpenAPIParameter> = {
+        $ref: '#/components/schemas/Test',
+        description: 'Overriden description',
+      };
+
+      expect(parser.shallowDeref(schemaOrRef)).toMatchSnapshot();
+    });
+
   });
 });
diff --git a/src/services/__tests__/__snapshots__/OpenAPIParser.test.ts.snap b/src/services/__tests__/__snapshots__/OpenAPIParser.test.ts.snap
index 74a26ed0..ffbcbff5 100644
--- a/src/services/__tests__/__snapshots__/OpenAPIParser.test.ts.snap
+++ b/src/services/__tests__/__snapshots__/OpenAPIParser.test.ts.snap
@@ -86,3 +86,10 @@ Object {
   ],
 }
 `;
+
+exports[`Models Schema should override description from $ref of the referenced component, when sibling description exists  1`] = `
+Object {
+  "description": "Overriden description",
+  "type": "object",
+}
+`;
diff --git a/src/services/__tests__/fixtures/siblingRefDescription.json b/src/services/__tests__/fixtures/siblingRefDescription.json
new file mode 100644
index 00000000..b090a963
--- /dev/null
+++ b/src/services/__tests__/fixtures/siblingRefDescription.json
@@ -0,0 +1,39 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "AA",
+    "version": "1.0"
+  },
+  "paths": {
+    "/test": {
+      "get": {
+        "operationId": "test",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "testAttr": {
+                      "description": "Overriden description",
+                      "$ref": "#/components/schemas/Test"
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "Test": {
+        "type": "object",
+        "description": "Refed description"
+      }
+    }
+  }
+}
diff --git a/src/services/models/Schema.ts b/src/services/models/Schema.ts
index d79d738b..1b23cf5f 100644
--- a/src/services/models/Schema.ts
+++ b/src/services/models/Schema.ts
@@ -78,7 +78,7 @@ export class SchemaModel {
     makeObservable(this);
 
     this.pointer = schemaOrRef.$ref || pointer || '';
-    this.rawSchema = parser.deref(schemaOrRef, false, true);
+    this.rawSchema = parser.shallowDeref(schemaOrRef);
     this.schema = parser.mergeAllOf(this.rawSchema, this.pointer, isChild);
 
     this.init(parser, isChild);

From fe6909ed80dd6053b48c30f63a2460614bf957a9 Mon Sep 17 00:00:00 2001
From: Roman Marshevskyy <roman.marshevskyy@redoc.ly>
Date: Mon, 11 Oct 2021 11:51:17 +0300
Subject: [PATCH 39/43] fix: OpenAPI 3.1: Missing description when $ref used
 #1727

---
 src/services/OpenAPIParser.ts    | 7 -------
 src/services/models/MediaType.ts | 2 +-
 src/utils/openapi.ts             | 4 ++--
 3 files changed, 3 insertions(+), 10 deletions(-)

diff --git a/src/services/OpenAPIParser.ts b/src/services/OpenAPIParser.ts
index 1683e927..399ce1d5 100644
--- a/src/services/OpenAPIParser.ts
+++ b/src/services/OpenAPIParser.ts
@@ -206,13 +206,6 @@ export class OpenAPIParser {
     }
   }
 
-  shalowDeref<T extends object>(obj: OpenAPIRef | T): T {
-    if (this.isRef(obj)) {
-      return this.byRef<T>(obj.$ref)!;
-    }
-    return obj;
-  }
-
   /**
    * Merge allOf constraints.
    * @param schema schema with allOF
diff --git a/src/services/models/MediaType.ts b/src/services/models/MediaType.ts
index 9e41d89a..25dae807 100644
--- a/src/services/models/MediaType.ts
+++ b/src/services/models/MediaType.ts
@@ -40,7 +40,7 @@ export class MediaTypeModel {
       this.examples = {
         default: new ExampleModel(
           parser,
-          { value: parser.shalowDeref(info.example) },
+          { value: parser.shallowDeref(info.example) },
           name,
           info.encoding,
         ),
diff --git a/src/utils/openapi.ts b/src/utils/openapi.ts
index ad267722..d0b081f5 100644
--- a/src/utils/openapi.ts
+++ b/src/utils/openapi.ts
@@ -505,13 +505,13 @@ export function mergeParams(
 ): Array<Referenced<OpenAPIParameter>> {
   const operationParamNames = {};
   operationParams.forEach(param => {
-    param = parser.shalowDeref(param);
+    param = parser.shallowDeref(param);
     operationParamNames[param.name + '_' + param.in] = true;
   });
 
   // filter out path params overridden by operation ones with the same name
   pathParams = pathParams.filter(param => {
-    param = parser.shalowDeref(param);
+    param = parser.shallowDeref(param);
     return !operationParamNames[param.name + '_' + param.in];
   });
 

From 952c05c6b4b95fe6082611fed9e2f0913272b904 Mon Sep 17 00:00:00 2001
From: AlexVarchuk <olexandr.varchuk@gmail.com>
Date: Mon, 11 Oct 2021 12:40:56 +0300
Subject: [PATCH 40/43] fix: improve publish action scripts (#1729)

---
 .github/workflows/demo-deploy-s3.yml |  42 ----------
 .github/workflows/e2e-tests.yml      |  12 +++
 .github/workflows/publish-cli.yml    | 115 +++++++++++++++++++++++++++
 .github/workflows/publish.yml        | 100 +++++++++++++++++++++++
 .github/workflows/unit-tests.yml     |   2 +-
 .travis.yml                          |  32 --------
 6 files changed, 228 insertions(+), 75 deletions(-)
 delete mode 100644 .github/workflows/demo-deploy-s3.yml
 create mode 100644 .github/workflows/e2e-tests.yml
 create mode 100644 .github/workflows/publish-cli.yml
 create mode 100644 .github/workflows/publish.yml
 delete mode 100644 .travis.yml

diff --git a/.github/workflows/demo-deploy-s3.yml b/.github/workflows/demo-deploy-s3.yml
deleted file mode 100644
index efb2ca19..00000000
--- a/.github/workflows/demo-deploy-s3.yml
+++ /dev/null
@@ -1,42 +0,0 @@
-name: Redoc demo CI/CD
-
-on:
-  push:
-    tags:
-      - v[0-9]*.[0-9]*.[0-9]*
-
-jobs:
-  build-and-unit:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v1
-      - run: npm ci
-      - run: npm run bundle
-      - run: npm test
-  deploy:
-    needs: build-and-unit
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v1
-      - name: cache node modules
-        uses: actions/cache@v1
-        with:
-          path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
-          key: npm-${{ hashFiles('package-lock.json') }}
-          restore-keys: |
-            npm-${{ hashFiles('package-lock.json') }}
-            npm-
-      - name: Configure AWS Credentials
-        uses: aws-actions/configure-aws-credentials@v1
-        with:
-          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
-          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
-          aws-region: us-east-1
-      - name: Install dependencies
-        run: npm ci
-      - name: Build package
-        run: npm run build:demo
-      - name: Deploy to S3 bucket
-        run: npm run deploy:demo
-      - name: Invalidate
-        run: aws cloudfront create-invalidation --distribution-id ${{ secrets.CF_DEMO_DISTRIBUTION_ID }} --paths "/*"
diff --git a/.github/workflows/e2e-tests.yml b/.github/workflows/e2e-tests.yml
new file mode 100644
index 00000000..514a3193
--- /dev/null
+++ b/.github/workflows/e2e-tests.yml
@@ -0,0 +1,12 @@
+name: Tests e2e
+
+on: [push]
+
+jobs:
+  build-and-e2e:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - run: npm ci
+    - run: npm run bundle
+    - run: npm run e2e
diff --git a/.github/workflows/publish-cli.yml b/.github/workflows/publish-cli.yml
new file mode 100644
index 00000000..9bfa3fff
--- /dev/null
+++ b/.github/workflows/publish-cli.yml
@@ -0,0 +1,115 @@
+name: Publish cli
+
+on:
+  push:
+    tags:
+      - v[0-9]*.[0-9]*.[0-9]*
+
+
+jobs:
+  bundle:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-node@v2
+    - name: Cache node modules
+      uses: actions/cache@v2
+      with:
+        path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+        key: npm-${{ hashFiles('package-lock.json') }}
+        restore-keys: |
+          npm-${{ hashFiles('package-lock.json') }}
+          npm-
+    - run: npm ci
+    - run: npm run bundle
+    - name: Store bundle artifact
+      uses: actions/upload-artifact@v2
+      with:
+        name: bundles-cli
+        path: bundles
+        retention-days: 1
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - run: npm test
+  e2e-tests:
+    needs: [bundle]
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - name: Download bundled artifact
+      uses: actions/download-artifact@v2
+      with:
+        name: bundles
+        path: bundles-cli
+    - run: npm run e2e
+  bundle-cli:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v2
+      - uses: actions/setup-node@v2
+      - name: Cache node modules
+        uses: actions/cache@v2
+        with:
+          path: ~/.npm
+          key: npm-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            npm-${{ hashFiles('package-lock.json') }}
+            npm-
+      - name: Install dependencies
+        run: npm ci
+      - name: Bundle
+        run: npm run compile:cli
+      - name: Store bundle artifact
+        uses: actions/upload-artifact@v2
+        with:
+          name: cli
+          path: cli
+          retention-days: 1
+  check-version-cli:
+    name: Check Version
+    runs-on: ubuntu-latest
+    needs: [bundle-cli, unit-tests, e2e-tests]
+    outputs:
+      changed: ${{ steps.check.outputs.changed }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v2
+      - name: Set up Node.js
+        uses: actions/setup-node@v2
+      - name: Check if version has been updated
+        id: check
+        uses: EndBug/version-check@v2.0.1
+        with:
+          file-name: ./cli/package.json
+          file-url: https://unpkg.com/redoc-cli/package.json
+          static-checking: localIsNew
+  publish-cli:
+    needs: [ check-version-cli ]
+    if: needs.check-version-cli.outputs.changed == 'true'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-node@v1
+        with:
+          node-version: "14.x"
+      - uses: actions/checkout@v2
+      - name: Download cli bundled artifact
+        uses: actions/download-artifact@v2
+        with:
+          name: cli
+          path: cli
+      - name: Cache node modules
+        uses: actions/cache@v2
+        with:
+          path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+          key: npm-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            npm-${{ hashFiles('package-lock.json') }}
+            npm-
+      - name: Publish to NPM
+        run: cd cli/ && npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml
new file mode 100644
index 00000000..d1c9ccbf
--- /dev/null
+++ b/.github/workflows/publish.yml
@@ -0,0 +1,100 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - v[0-9]*.[0-9]*.[0-9]*
+
+jobs:
+  bundle:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v2
+    - uses: actions/setup-node@v2
+    - name: Cache node modules
+      uses: actions/cache@v2
+      with:
+        path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+        key: npm-${{ hashFiles('package-lock.json') }}
+        restore-keys: |
+          npm-${{ hashFiles('package-lock.json') }}
+          npm-
+    - run: npm ci
+    - run: npm run bundle
+    - name: Store bundle artifact
+      uses: actions/upload-artifact@v2
+      with:
+        name: bundles
+        path: bundles
+        retention-days: 1
+  unit-tests:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - run: npm test
+  e2e-tests:
+    needs: [bundle]
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v1
+    - run: npm ci
+    - name: Download bundled artifact
+      uses: actions/download-artifact@v2
+      with:
+        name: bundles
+        path: bundles
+    - run: npm run e2e
+  deploy-demo:
+    needs: [bundle, unit-tests, e2e-tests]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v1
+      - name: Configure AWS Credentials
+        uses: aws-actions/configure-aws-credentials@v1
+        with:
+          aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
+          aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
+          aws-region: us-east-1
+      - name: Install dependencies
+        run: npm ci
+      - name: Download bundled artifacts
+        uses: actions/download-artifact@v2
+        with:
+          name: bundles
+          path: bundles
+      - name: Build package
+        run: npm run build:demo
+      - name: Deploy to S3 bucket
+        run: npm run deploy:demo
+      - name: Invalidate
+        run: aws cloudfront create-invalidation --distribution-id ${{ secrets.CF_DEMO_DISTRIBUTION_ID }} --paths "/*"
+  publish:
+    needs: [bundle, unit-tests, e2e-tests]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/setup-node@v1
+        with:
+          node-version: "14.x"
+      - uses: actions/checkout@v2
+      - name: Download bundled artifacts
+        uses: actions/download-artifact@v2
+        with:
+          name: bundles
+          path: bundles
+      - name: Cache node modules
+        uses: actions/cache@v2
+        with:
+          path: ~/.npm # npm cache files are stored in `~/.npm` on Linux/macOS
+          key: npm-${{ hashFiles('package-lock.json') }}
+          restore-keys: |
+            npm-${{ hashFiles('package-lock.json') }}
+            npm-
+      - name: Before deploy
+        run: npm run declarations
+      - name: Publish to NPM
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      - name: After script
+        run: cat ./coverage/lcov.info | coveralls
diff --git a/.github/workflows/unit-tests.yml b/.github/workflows/unit-tests.yml
index 09e54a63..a0a0bbd1 100644
--- a/.github/workflows/unit-tests.yml
+++ b/.github/workflows/unit-tests.yml
@@ -9,4 +9,4 @@ jobs:
     - uses: actions/checkout@v1
     - run: npm ci
     - run: npm run bundle
-    - run: npm test
+    - run: npm test
\ No newline at end of file
diff --git a/.travis.yml b/.travis.yml
deleted file mode 100644
index 03ac1fa4..00000000
--- a/.travis.yml
+++ /dev/null
@@ -1,32 +0,0 @@
-language: node_js
-node_js:
-- '12'
-cache:
-  directories:
-  - "~/.cache"
-env:
-  global:
-    - GH_REF: github.com/Redocly/redoc.git
-    - GIT_AUTHOR_EMAIL: redoc-bot@users.noreply.github.com
-    - GIT_AUTHOR_NAME: RedocBot
-    - secure: apiavCfCQngL9Een1m7MIXMf3bqO3rY4YY59TMBl/yFKi80CEsHPHhgVUkl6hC+aM5PeBt/vgjh37rHMX31j/pcSZ4Z8SO/4Bwr36iHfhSxSEuAQog8P07qWqH7wYYWGIVmF682stgl0fYF+GN92sx/6edFVzsWVECf2G7imtICKSTbhKGm3Dhn2JwGnhD7eyfgZ33omgiaswumdu0xABoXDfqSZR+16fC4Ap5rhv3fXO9ndvRNy1STn376nT+my6e86UrQL4aS/S+HNHgIe1BUs+5cOp6Jgw6t0ie7phY0EAiECsRxy9K4e3Dctv9m6+Wma4+vy65MS0zGyrqey6oyV4l827sCOjrD1qcqc9bX6FlMSouVoNfE4ZjINNAbgigTaiLSoDSPcf5I5smkkM2ezzFOMSZwZxNdaNL2LKb97vc8m/ZUkv0sKZyT7oqVL7aJweEivsSHj5l2KR8Z7XrVB1y2eI6GvyTSa/d+CL4dSRzjh8+IRN047YBrdTKD5IkdT0upfoBu14WPUfFmLKxX+iMCslXRWb6kwojhrWNYmZvL65KRAzJ6+eIPDG/W5QUOpYyYT77bLlBQjVo6NmVvl9v3HMECq9CHH0ivKFBGPiKMOx7cJkTax3FuyznOW2WCXB9kTb5Zk9toaiNlSp9L6ll/h2Eyxa6n6sWUgmmM=
-    - secure: vVRg9BKGBwF2MbXQnEccFL+XW0/7RaBmge9k7jbGYScBwkP3XjnQ/Xaj0cvTz2CM2EqXsbpwfvr4Jo+enW/E3MGy5RiEzv5hUe/jIFRR0gfAFbZxSTvg5xiFhTDffqQk0fncO4jXu+wPO5lZ2CMRWzyXz3i1MZhjMcAgoDr1+TRss/EGXLNHxr2RM88tpUW0fV2prIRoyGqhCgnYZtrm7hmr41Ej+itg1MqZLml/Rjkt3KsNgI+z0O5Qn3QSAO8GtPZqeftQxAjevOmxZGcssxY8EJvqbjAujr4y51WncXpEmCRPSY2J9R5+fkgZurqwnJapbQpjwKYemok3ps7EHg2gWkAlmPdQO4LKpbffGkM/o5b+8+HdIuQZugsSWQD9hUSftTAFLcfA1isi7V2lHE1m8bX/vk9zIyDdcPSwIaFe9y+w3PexwFmTjPLq+nia/UY2kARFZMEIFAJby6gkA70DcAJ50QOM86InJu5DSzGbIssgTGAXCn0TPPyGveaurVLw8x61j3yh8LDF46gUHey3rqv6WjpCM9h/vg7X/gq5ve/5Q2KHscUKfs/sA53Mt7qPeqRZY1QCaaRjzqJO/ZraHqWWeKmPKaWhPGR0kYEnkvB+K9GZ+HNSWCltjCO4SJ1xeEl7CRqQxAwdiMATF5SKqyiC+bn5oc35mFgbRF8=
-    - secure: ela1tn4wkJQZ8O4iv+4pIZi5cebxeCStVF1tEUe6qa6WWgJYVXmS2tEv3QQ36NUBFrP58Y6yl10XguPnvj/2BCqcZI4FUBHh3BfiBoUtXxDCVKI5LtlniNiOFGUwfzEeYka8T51zFlcUXSCCaxHkRZbmBsIzeJ39UwTi5fy0qwLv9GgL0czhwm8I8sZ8gyWdGmqpXNFEsb9JP4ZA3mw2qpWkGpGAqQPD9XSCkU3LmX1/ltwsBMAgGYKLLo7vU8d5KV2c8L1Gnxfl6BvfmqUD/dsas/1rnk08rU2nez5ekuQa2tJRkDLOv8bqvrGRLjHSUa3yPuisC6SsDGSU7/3DcozZyYsz7WQ6WI8tYabyjqqeJTF1N8a5T3IbZaZNV1J4JHOO9Cb/y7gIg4edANg6tbe7MzZpdEPRBnw6OkdTdirpNsWQ/jnfpY1hn6mraQZz/q8yaz3W21NjbBJhVnvfh5gWLKQ3YAAziCBhmmrThFhUu0czz+G920MuFo477TBcxvlrE7CaNJ0Q6yYkDehEPOv3jvEs1QVHPwuRrlaLTbBhrlTICKZ58gdX30O8N4i0Xgp/v6qrC03bplnMQc8E/uC61wcVLJixnlZVp8FODpUvPjsxVFkpuNSOIAaiqcERmoiPXx05Epzmr78hjU5rYCx/1MmVoeB4gs9YO+4guD4=
-addons:
-  chrome: stable
-  apt:
-    packages:
-    - libgconf-2-4
-before_script: npm run bundle
-script: npm test && ([ "${TRAVIS_PULL_REQUEST}" = "false" ] && npm run e2e-ci || npm
-  run e2e)
-after_script: cat ./coverage/lcov.info | coveralls
-before_deploy: npm run compile:cli && npm run declarations
-deploy:
-- provider: npm
-  skip_cleanup: true
-  email: gotsijroman@gmail.com
-  tag: next
-  api_key: "$NPM_TOKEN"
-  on:
-    tags: true

From 43451ba4cd24270b8629a967d3fd2ce2eed8912e Mon Sep 17 00:00:00 2001
From: kylenarocroc <3884351+kylenarocroc@users.noreply.github.com>
Date: Mon, 11 Oct 2021 10:50:09 +0100
Subject: [PATCH 41/43] feat: add q/kdb+ syntax highlighting (#1605)

---
 src/utils/highlight.ts | 1 +
 1 file changed, 1 insertion(+)

diff --git a/src/utils/highlight.ts b/src/utils/highlight.ts
index 036b9129..23cdd43d 100644
--- a/src/utils/highlight.ts
+++ b/src/utils/highlight.ts
@@ -15,6 +15,7 @@ import 'prismjs/components/prism-objectivec.js';
 import 'prismjs/components/prism-perl.js';
 import 'prismjs/components/prism-php.js';
 import 'prismjs/components/prism-python.js';
+import 'prismjs/components/prism-q.js';
 import 'prismjs/components/prism-ruby.js';
 import 'prismjs/components/prism-scala.js';
 import 'prismjs/components/prism-sql.js';

From 3b8d6441bd9978b849a53021d40fd4fe150272ea Mon Sep 17 00:00:00 2001
From: Andriy Zaleskyy <zal3sky@gmail.com>
Date: Mon, 11 Oct 2021 13:05:50 +0300
Subject: [PATCH 42/43] fix: The number of items in the array in the array is
 incorrect #1762 (#1763)

---
 demo/openapi-3-1.yaml                         | 14 ++++++++++++
 demo/openapi.yaml                             |  2 ++
 src/components/Schema/ArraySchema.tsx         | 13 +++++------
 .../DiscriminatorDropdown.test.tsx.snap       |  4 ++++
 src/services/models/Schema.ts                 |  4 ++++
 .../loadAndBundleSpec.test.ts.snap            | 22 +++++++++++++++++++
 src/utils/__tests__/openapi.test.ts           |  8 +++----
 7 files changed, 55 insertions(+), 12 deletions(-)

diff --git a/demo/openapi-3-1.yaml b/demo/openapi-3-1.yaml
index 31063d4b..ac89619d 100644
--- a/demo/openapi-3-1.yaml
+++ b/demo/openapi-3-1.yaml
@@ -533,6 +533,20 @@ paths:
                   subscriptionId:
                     type: string
                     example: AAA-123-BBB-456
+        '200':
+          description: Successful operation
+          content:
+            application/json:
+              schema:
+                type: array
+                maxItems: 999
+                minItems: 0
+                items:
+                  type: array
+                  maxItems: 777
+                  minItems: 111
+                  items:
+                    type: number
       callbacks:
         orderInProgress:
           '{$request.body#/callbackUrl}?event={$request.body#/eventName}':
diff --git a/demo/openapi.yaml b/demo/openapi.yaml
index c570cc60..5cf19340 100644
--- a/demo/openapi.yaml
+++ b/demo/openapi.yaml
@@ -377,7 +377,9 @@ paths:
             application/xml:
               schema:
                 type: array
+                maxItems: 999
                 items:
+                  maxItems: 111
                   $ref: '#/components/schemas/Pet'
         '400':
           description: Invalid tag value
diff --git a/src/components/Schema/ArraySchema.tsx b/src/components/Schema/ArraySchema.tsx
index eab37595..0b555c07 100644
--- a/src/components/Schema/ArraySchema.tsx
+++ b/src/components/Schema/ArraySchema.tsx
@@ -13,15 +13,12 @@ const PaddedSchema = styled.div`
 
 export class ArraySchema extends React.PureComponent<SchemaProps> {
   render() {
-    const itemsSchema = this.props.schema.items!;
     const schema = this.props.schema;
+    const itemsSchema = schema.items;
 
-    const itemConstraintSchema = (
-      min: number | undefined = undefined,
-      max: number | undefined = undefined,
-    ) => ({ type: 'array', minItems: min, maxItems: max });
-
-    const minMaxItems = humanizeConstraints(itemConstraintSchema(itemsSchema?.schema?.minItems, itemsSchema?.schema?.maxItems));
+    const minMaxItems = schema.minItems === undefined && schema.maxItems === undefined ?
+      '' :
+      `(${humanizeConstraints(schema)})`;
 
     if (schema.displayType && !itemsSchema && !minMaxItems.length) {
       return (<div>
@@ -31,7 +28,7 @@ export class ArraySchema extends React.PureComponent<SchemaProps> {
 
     return (
       <div>
-        <ArrayOpenningLabel> Array ({minMaxItems})</ArrayOpenningLabel>
+        <ArrayOpenningLabel> Array {minMaxItems}</ArrayOpenningLabel>
         <PaddedSchema>
           <Schema {...this.props} schema={itemsSchema} />
         </PaddedSchema>
diff --git a/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap b/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap
index fe5617ed..7af7b482 100644
--- a/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap
+++ b/src/components/__tests__/__snapshots__/DiscriminatorDropdown.test.tsx.snap
@@ -33,6 +33,8 @@ exports[`Components SchemaView discriminator should correctly render discriminat
             "format": undefined,
             "isCircular": undefined,
             "isPrimitive": true,
+            "maxItems": undefined,
+            "minItems": undefined,
             "options": "<<<filtered>>>",
             "pattern": undefined,
             "pointer": "#/components/schemas/Dog/properties/packSize",
@@ -86,6 +88,8 @@ exports[`Components SchemaView discriminator should correctly render discriminat
             "format": undefined,
             "isCircular": undefined,
             "isPrimitive": true,
+            "maxItems": undefined,
+            "minItems": undefined,
             "options": "<<<filtered>>>",
             "pattern": undefined,
             "pointer": "#/components/schemas/Dog/properties/type",
diff --git a/src/services/models/Schema.ts b/src/services/models/Schema.ts
index 1b23cf5f..81dc7ee3 100644
--- a/src/services/models/Schema.ts
+++ b/src/services/models/Schema.ts
@@ -63,6 +63,8 @@ export class SchemaModel {
   const: any;
   contentEncoding?: string;
   contentMediaType?: string;
+  minItems?: number;
+  maxItems?: number;
 
   /**
    * @param isChild if schema discriminator Child
@@ -128,6 +130,8 @@ export class SchemaModel {
     this.const = schema.const || '';
     this.contentEncoding = schema.contentEncoding;
     this.contentMediaType = schema.contentMediaType;
+    this.minItems = schema.minItems;
+    this.maxItems = schema.maxItems;
 
     if (!!schema.nullable || schema['x-nullable']) {
       if (Array.isArray(this.type) && !this.type.some((value) => value === null || value === 'null')) {
diff --git a/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap b/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap
index 7807e39e..6cd0a034 100644
--- a/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap
+++ b/src/utils/__tests__/__snapshots__/loadAndBundleSpec.test.ts.snap
@@ -729,7 +729,9 @@ try {
                 "schema": Object {
                   "items": Object {
                     "$ref": "#/components/schemas/Pet",
+                    "maxItems": 111,
                   },
+                  "maxItems": 999,
                   "type": "array",
                 },
               },
@@ -3245,6 +3247,26 @@ culpa qui officia deserunt mollit anim id est laborum.
           },
         },
         "responses": Object {
+          "200": Object {
+            "content": Object {
+              "application/json": Object {
+                "schema": Object {
+                  "items": Object {
+                    "items": Object {
+                      "type": "number",
+                    },
+                    "maxItems": 777,
+                    "minItems": 111,
+                    "type": "array",
+                  },
+                  "maxItems": 999,
+                  "minItems": 0,
+                  "type": "array",
+                },
+              },
+            },
+            "description": "Successful operation",
+          },
           "201": Object {
             "content": Object {
               "application/json": Object {
diff --git a/src/utils/__tests__/openapi.test.ts b/src/utils/__tests__/openapi.test.ts
index d4f23e02..6f40d974 100644
--- a/src/utils/__tests__/openapi.test.ts
+++ b/src/utils/__tests__/openapi.test.ts
@@ -412,10 +412,10 @@ describe('Utils', () => {
 
   describe('openapi humanizeConstraints', () => {
     const itemConstraintSchema = (
-      min: number | undefined = undefined,
-      max: number | undefined = undefined,
-      multipleOf: number | undefined = undefined,
-      uniqueItems?: boolean,
+      min?: number,
+      max?: number,
+      multipleOf?: number,
+      uniqueItems?: boolean
     ) => ({ type: 'array', minItems: min, maxItems: max, multipleOf, uniqueItems });
 
     it('should not have a humanized constraint without schema constraints', () => {

From 4fb9c835256b9e44bcecabde7baf0f0f3e5beb3f Mon Sep 17 00:00:00 2001
From: Roman Hotsiy <gotsijroman@gmail.com>
Date: Mon, 11 Oct 2021 15:02:08 +0300
Subject: [PATCH 43/43] fix: fix deref logic for oas3.1 (#1767)

---
 src/services/OpenAPIParser.ts | 2 +-
 src/services/models/Schema.ts | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/services/OpenAPIParser.ts b/src/services/OpenAPIParser.ts
index 399ce1d5..4881c99e 100644
--- a/src/services/OpenAPIParser.ts
+++ b/src/services/OpenAPIParser.ts
@@ -195,7 +195,7 @@ export class OpenAPIParser {
     }
     if (mergeAsAllOf && keys.some((k) => k !== 'description' && k !== 'title' && k !== 'externalDocs')) {
       return {
-        allOf: [resolved, rest],
+        allOf: [rest, resolved],
       };
     } else {
       // small optimization
diff --git a/src/services/models/Schema.ts b/src/services/models/Schema.ts
index 81dc7ee3..b155d254 100644
--- a/src/services/models/Schema.ts
+++ b/src/services/models/Schema.ts
@@ -80,7 +80,7 @@ export class SchemaModel {
     makeObservable(this);
 
     this.pointer = schemaOrRef.$ref || pointer || '';
-    this.rawSchema = parser.shallowDeref(schemaOrRef);
+    this.rawSchema = parser.deref(schemaOrRef, false, true);
     this.schema = parser.mergeAllOf(this.rawSchema, this.pointer, isChild);
 
     this.init(parser, isChild);
@@ -363,7 +363,7 @@ function buildFields(
 ): FieldModel[] {
   const props = schema.properties || {};
   const additionalProps = schema.additionalProperties;
-  const defaults = schema.default || {};
+  const defaults = schema.default;
   let fields = Object.keys(props || []).map((fieldName) => {
     let field = props[fieldName];
 
@@ -384,7 +384,7 @@ function buildFields(
         required,
         schema: {
           ...field,
-          default: field.default === undefined ? defaults[fieldName] : field.default,
+          default: field.default === undefined && defaults ? defaults[fieldName] : field.default,
         },
       },
       $ref + '/properties/' + fieldName,