diff --git a/oas/latest.html b/oas/latest.html
index fca28102c4..0b173d3366 100644
--- a/oas/latest.html
+++ b/oas/latest.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.1.0 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "},{"name":"Uri Sarid "}],"formerEditors":[{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2021-02-15T00:00:00.000Z","subtitle":"Version 3.1.0","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.1.0 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "}],"formerEditors":[{"name":"Uri Sarid "},{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2021-02-15T00:00:00.000Z","subtitle":"Version 3.1.0","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-831873-42"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
@@ -16,13 +16,13 @@
 <p>An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.</p>
 <!-- /TOC -->
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="oasDocument"><dfn>OpenAPI Document</dfn></span></h4>
+<p><a id="oasDocument"></a><section><h4><span><dfn>OpenAPI Document</dfn></span></h4></p>
 <p>A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one <a href="#pathsObject">paths</a> field, a <a href="#oasComponents">components</a> field or a <a href="#oasWebhooks">webhooks</a> field. An OpenAPI document uses and conforms to the OpenAPI Specification.</p>
-</section><section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a></section><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.</p>
 <p>Each template expression in the path MUST correspond to a path parameter that is included in the <a href="#path-item-object">Path Item</a> itself and/or in each of the Path Item’s <a href="#operation-object">Operations</a>. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.</p>
 <p>The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (<code>/</code>), question marks (<code>?</code>), or hashes (<code>#</code>).</p>
-</section><section><h4><span id="mediaTypes"><dfn>Media Types</dfn></span></h4>
+<p><a id="mediaTypes"></a></section><section><h4><span><dfn>Media Types</dfn></span></h4></p>
 <p>Media type definitions are spread across several resources.
 The media type definitions SHOULD be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible media type definitions:</p>
@@ -38,7 +38,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation.
 The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the <a href="https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
@@ -50,9 +50,9 @@
 <p>An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.</p>
 <p>For example, if a field has an array value, the JSON array representation will be used:</p>
 <pre class="nohighlight"><code>
-{
-   <span class="hljs-attr">&quot;field&quot;</span>: [ <span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span> ]
-}
+<span class="hljs-punctuation">{</span>
+   <span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span> <span class="hljs-number">1</span><span class="hljs-punctuation">,</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span> <span class="hljs-number">3</span> <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>All field names in the specification are <strong>case sensitive</strong>.
 This includes all fields that are used as keys in a map, except where explicitly noted that keys are <strong>case insensitive</strong>.</p>
@@ -64,10 +64,10 @@
 <li>Keys used in YAML maps MUST be limited to a scalar string, as defined by the <a href="https://yaml.org/spec/1.2/spec.html#id2802346">YAML Failsafe schema ruleset</a>.</li>
 </ul>
 <p><strong>Note:</strong> While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.</p>
-</section><section><h2><span id="documentStructure">Document Structure</span></h2>
+<p><a id="documentStructure"></a></section><section><h2><span>Document Structure</span></h2></p>
 <p>An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, <a href="#referenceObject"><code>Reference Objects</code></a> and <a href="#schemaObject"><code>Schema Object</code></a> <code>$ref</code> keywords are used.</p>
 <p>It is RECOMMENDED that the root OpenAPI document be named: <code>openapi.json</code> or <code>openapi.yaml</code>.</p>
-</section><section><h2><span id="dataTypes">Data Types</span></h2>
+<p><a id="dataTypes"></a></section><section><h2><span>Data Types</span></h2></p>
 <p>Data types in the OAS are based on the types supported by the <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00#section-4.2.1">JSON Schema Specification Draft 2020-12</a>.
 Note that <code>integer</code> as a type is also supported and is defined as a JSON number without a fraction or exponent part.
 Models are defined using the <a href="#schemaObject">Schema Object</a>, which is a superset of JSON Schema Specification Draft 2020-12.</p>
@@ -110,20 +110,20 @@
 </tr>
 </tbody>
 </table>
-</section><section><h2><span id="richText">Rich Text Formatting</span></h2>
+<p><a id="richText"></a></section><section><h2><span>Rich Text Formatting</span></h2></p>
 <p>Throughout the specification <code>description</code> fields are noted as supporting CommonMark markdown formatting.
 Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by <a href="https://spec.commonmark.org/0.27/">CommonMark 0.27</a>. Tooling MAY choose to ignore some CommonMark features to address security concerns.</p>
-</section><section><h2><span id="relativeReferencesURI">Relative References in URIs</span></h2>
+<p><a id="relativeReferencesURI"></a></section><section><h2><span>Relative References in URIs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].</p>
 <p>Relative references, including those in <a href="#referenceObject"><code>Reference Objects</code></a>, <a href="#pathItemObject"><code>PathItem Object</code></a> <code>$ref</code> fields, <a href="#linkObject"><code>Link Object</code></a> <code>operationRef</code> fields and <a href="#exampleObject"><code>Example Object</code></a> <code>externalValue</code> fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].</p>
 <p>If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document.  If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].</p>
 <p>Relative references in <a href="#schemaObject"><code>Schema Objects</code></a>, including any that appear as <code>$id</code> values, use the nearest parent <code>$id</code> as a Base URI, as described by <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00#section-8.2">JSON Schema Specification Draft 2020-12</a>.  If no parent schema contains an <code>$id</code>, then the Base URI MUST be determined according to [[!RFC3986]].</p>
-</section><section><h2><span id="relativeReferencesURL">Relative References in URLs</span></h2>
+<p><a id="relativeReferencesURL"></a></section><section><h2><span>Relative References in URLs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]].
 Unless specified otherwise, relative references are resolved using the URLs defined in the <a href="#serverObject"><code>Server Object</code></a> as a Base URL. Note that these themselves MAY be relative to the referring document.</p>
 </section><section><h2>Schema</h2>
 <p>In the following description, if a field is not explicitly <strong>REQUIRED</strong> or described with a MUST or SHALL, it can be considered OPTIONAL.</p>
-<section><h3><span id="oasObject">OpenAPI Object</span></h3>
+<p><a id="oasObject"></a><section><h3><span>OpenAPI Object</span></h3></p>
 <p>This is the root object of the <a href="#oasDocument">OpenAPI document</a>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -188,7 +188,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API.
 The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.</p>
 <section><h4>Fixed Fields</h4>
@@ -241,22 +241,22 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Info Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;Sample Pet Store App&quot;</span>,
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;A pet store manager.&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span>,
-  <span class="hljs-attr">&quot;termsOfService&quot;</span>: <span class="hljs-string">&quot;https://example.com/terms/&quot;</span>,
-  <span class="hljs-attr">&quot;contact&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.example.com/support&quot;</span>,
-    <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-  },
-  <span class="hljs-attr">&quot;license&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-  },
-  <span class="hljs-attr">&quot;version&quot;</span>: <span class="hljs-string">&quot;1.0.1&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;title&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Sample Pet Store App&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A pet store manager.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;termsOfService&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/terms/&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;contact&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;license&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;version&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;1.0.1&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">title:</span> <span class="hljs-string">Sample</span> <span class="hljs-string">Pet</span> <span class="hljs-string">Store</span> <span class="hljs-string">App</span>
@@ -272,7 +272,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -304,18 +304,18 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Contact Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.example.com/support&quot;</span>,
-  <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">API</span> <span class="hljs-string">Support</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.example.com/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@example.com</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -335,7 +335,7 @@
 <tr>
 <td><a id="licenseIdentifier"> </a>identifier</td>
 <td style="text-align:center"><code>string</code></td>
-<td>An <a href="https://spdx.org/spdx-specification-21-web-version#h.jxpfx0ykyb60">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field.</td>
+<td>An <a href="https://spdx.org/licenses/">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field.</td>
 </tr>
 <tr>
 <td><a id="licenseUrl"> </a>url</td>
@@ -347,16 +347,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>License Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-  <span class="hljs-attr">&quot;identifier&quot;</span>: <span class="hljs-string">&quot;Apache-2.0&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;identifier&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache-2.0&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">identifier:</span> <span class="hljs-string">Apache-2.0</span>
 </code></pre>
-</section></section><section><h3><span id="serverObject">Server Object</span></h3>
+<p><a id="serverObject"></a></section></section><section><h3><span>Server Object</span></h3></p>
 <p>An object representing a Server.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -389,10 +389,10 @@
 </section><section><h4>Server Object Example</h4>
 <p>A single server would be described as:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://development.gigantic-server.com/v1</span>
@@ -400,22 +400,22 @@
 </code></pre>
 <p>The following shows how multiple servers can be described, for example, at the OpenAPI Object’s <a href="#oasServers"><code>servers</code></a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Staging server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Production server&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Staging server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Production server&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -428,30 +428,30 @@
 </code></pre>
 <p>The following shows how variables can be used for a server configuration:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The production API server&quot;</span>,
-      <span class="hljs-attr">&quot;variables&quot;</span>: {
-        <span class="hljs-attr">&quot;username&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;demo&quot;</span>,
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
-        },
-        <span class="hljs-attr">&quot;port&quot;</span>: {
-          <span class="hljs-attr">&quot;enum&quot;</span>: [
-            <span class="hljs-string">&quot;8443&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The production API server&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;variables&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;username&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;demo&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;port&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+            <span class="hljs-string">&quot;8443&quot;</span><span class="hljs-punctuation">,</span>
             <span class="hljs-string">&quot;443&quot;</span>
-          ],
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;8443&quot;</span>
-        },
-        <span class="hljs-attr">&quot;basePath&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;v2&quot;</span>
-        }
-      }
-    }
-  ]
-}
+          <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;8443&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;basePath&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;v2&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -471,7 +471,7 @@
       <span class="hljs-comment"># open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`</span>
       <span class="hljs-attr">default:</span> <span class="hljs-string">v2</span>
 </code></pre>
-</section></section><section><h3><span id="serverVariableObject">Server Variable Object</span></h3>
+<p><a id="serverVariableObject"></a></section></section><section><h3><span>Server Variable Object</span></h3></p>
 <p>An object representing a Server Variable for server URL template substitution.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -501,7 +501,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="componentsObject">Components Object</span></h3>
+<p><a id="componentsObject"></a></section></section><section><h3><span>Components Object</span></h3></p>
 <p>Holds a set of reusable objects for different aspects of the OAS.
 All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.</p>
 <section><h4>Fixed Fields</h4>
@@ -578,105 +578,105 @@
 </code></pre>
 </section><section><h4>Components Object Example</h4>
 <pre class="nohighlight"><code>
-&quot;components&quot;: {
-  &quot;schemas&quot;: {
-    &quot;GeneralError&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;code&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int32&quot;
-        },
-        &quot;message&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Category&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Tag&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    }
-  },
-  &quot;parameters&quot;: {
-    &quot;skipParam&quot;: {
-      &quot;name&quot;: &quot;skip&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;number of items to skip&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot;: {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    },
-    &quot;limitParam&quot;: {
-      &quot;name&quot;: &quot;limit&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;max records to return&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot; : {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    }
-  },
-  &quot;responses&quot;: {
-    &quot;NotFound&quot;: {
-      &quot;description&quot;: &quot;Entity not found.&quot;
-    },
-    &quot;IllegalInput&quot;: {
-      &quot;description&quot;: &quot;Illegal input for operation.&quot;
-    },
-    &quot;GeneralError&quot;: {
-      &quot;description&quot;: &quot;General Error&quot;,
-      &quot;content&quot;: {
-        &quot;application/json&quot;: {
-          &quot;schema&quot;: {
-            &quot;$ref&quot;: &quot;#/components/schemas/GeneralError&quot;
-          }
-        }
-      }
-    }
-  },
-  &quot;securitySchemes&quot;: {
-    &quot;api_key&quot;: {
-      &quot;type&quot;: &quot;apiKey&quot;,
-      &quot;name&quot;: &quot;api_key&quot;,
-      &quot;in&quot;: &quot;header&quot;
-    },
-    &quot;petstore_auth&quot;: {
-      &quot;type&quot;: &quot;oauth2&quot;,
-      &quot;flows&quot;: {
-        &quot;implicit&quot;: {
-          &quot;authorizationUrl&quot;: &quot;https://example.org/api/oauth/dialog&quot;,
-          &quot;scopes&quot;: {
-            &quot;write:pets&quot;: &quot;modify pets in your account&quot;,
-            &quot;read:pets&quot;: &quot;read your pets&quot;
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Category&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Tag&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;skipParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number of items to skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;limitParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;limit&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;max records to return&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;NotFound&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Entity not found.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;IllegalInput&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Illegal input for operation.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;General Error&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/GeneralError&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;securitySchemes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.org/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -747,7 +747,7 @@
             <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
             <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints and their operations.
 The path is appended to the URL from the <a href="#serverObject"><code>Server Object</code></a> in order to construct the full URL.  The Paths MAY be empty, due to <a href="#securityFiltering">Access Control List (ACL) constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -786,28 +786,28 @@
 </code></pre>
 </section><section><h4>Paths Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;/pets&quot;</span>: {
-    <span class="hljs-attr">&quot;get&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span>,
-      <span class="hljs-attr">&quot;responses&quot;</span>: {
-        <span class="hljs-attr">&quot;200&quot;</span>: {          
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A list of pets.&quot;</span>,
-          <span class="hljs-attr">&quot;content&quot;</span>: {
-            <span class="hljs-attr">&quot;application/json&quot;</span>: {
-              <span class="hljs-attr">&quot;schema&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-                <span class="hljs-attr">&quot;items&quot;</span>: {
-                  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;/pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>          
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A list of pets.&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
+                <span class="hljs-punctuation">}</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">/pets:</span>
@@ -823,7 +823,7 @@
               <span class="hljs-attr">items:</span>
                 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.
 The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
@@ -907,53 +907,53 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Path Item Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;get&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns pets based on ID&quot;</span>,
-    <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Find pets by ID&quot;</span>,
-    <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;getPetsById&quot;</span>,
-    <span class="hljs-attr">&quot;responses&quot;</span>: {
-      <span class="hljs-attr">&quot;200&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;pet response&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;*/*&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-              <span class="hljs-attr">&quot;items&quot;</span>: {
-                <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-              }
-            }
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;default&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;error payload&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;text/html&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-            }
-          }
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet to use&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      },
-      <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns pets based on ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find pets by ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;getPetsById&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet response&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;error payload&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;text/html&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet to use&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">get:</span>
@@ -986,7 +986,7 @@
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>  
   <span class="hljs-attr">style:</span> <span class="hljs-string">simple</span>
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1031,7 +1031,7 @@
 <tr>
 <td><a id="operationRequestBody"> </a>requestBody</td>
 <td style="text-align:center"><a href="#requestBodyObject">Request Body Object</a> | <a href="#referenceObject">Reference Object</a></td>
-<td>The request body applicable for this operation.  The <code>requestBody</code> is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), <code>requestBody</code> is permitted but does not have well-defined semantics and SHOULD be avoided if possible.</td>
+<td>The request body applicable for this operation.  The <code>requestBody</code> is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague (such as <a href="https://tools.ietf.org/html/rfc7231#section-4.3.1">GET</a>, <a href="https://tools.ietf.org/html/rfc7231#section-4.3.2">HEAD</a> and <a href="https://tools.ietf.org/html/rfc7231#section-4.3.5">DELETE</a>), <code>requestBody</code> is permitted but does not have well-defined semantics and SHOULD be avoided if possible.</td>
 </tr>
 <tr>
 <td><a id="operationResponses"> </a>responses</td>
@@ -1063,68 +1063,68 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Operation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;tags&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;tags&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;pet&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span>,
-  <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;updatePetWithForm&quot;</span>,
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;petId&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  ],
-  <span class="hljs-attr">&quot;requestBody&quot;</span>: {
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-          <span class="hljs-attr">&quot;properties&quot;</span>: {
-            <span class="hljs-attr">&quot;name&quot;</span>: { 
-              <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated name of the pet&quot;</span>,
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-            },
-            <span class="hljs-attr">&quot;status&quot;</span>: {
-              <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated status of the pet&quot;</span>,
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-            }
-          },
-          <span class="hljs-attr">&quot;required&quot;</span>: [<span class="hljs-string">&quot;status&quot;</span>] 
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;responses&quot;</span>: {
-    <span class="hljs-attr">&quot;200&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pet updated.&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    },
-    <span class="hljs-attr">&quot;405&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Method Not Allowed&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;updatePetWithForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petId&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;requestBody&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span> 
+              <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated name of the pet&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;status&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated status of the pet&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-string">&quot;status&quot;</span><span class="hljs-punctuation">]</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet updated.&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;405&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Method Not Allowed&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">tags:</span>
@@ -1168,7 +1168,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1195,16 +1195,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>External Documentation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Find more info here&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find more info here&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://example.com</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <section><h4>Parameter Locations</h4>
@@ -1319,7 +1319,7 @@
 </tr>
 </tbody>
 </table>
-</section><section><h4><span id="styleValues">Style Values</span></h4>
+<p><a id="styleValues"></a></section><section><h4><span>Style Values</span></h4></p>
 <p>In order to support common ways of serializing simple parameters, a set of <code>style</code> values are defined.</p>
 <table>
 <thead>
@@ -1489,20 +1489,20 @@
 </section><section><h4>Parameter Object Examples</h4>
 <p>A header parameter with an array of 64 bit integer numbers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;token&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;token to be passed as a header&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token to be passed as a header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">token</span>
@@ -1518,15 +1518,15 @@
 </code></pre>
 <p>A path parameter of a string value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;username&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;username to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">username</span>
@@ -1538,20 +1538,20 @@
 </code></pre>
 <p>An optional query parameter of a string value, allowing multiple values by repeating the query parameter:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of the object to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">false</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>,
-  <span class="hljs-attr">&quot;explode&quot;</span>: <span class="hljs-literal">true</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of the object to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;explode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">id</span>
@@ -1567,17 +1567,17 @@
 </code></pre>
 <p>A free-form query parameter, allowing undefined parameters of a specific type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;freeForm&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-    },
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;freeForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1590,29 +1590,29 @@
 </code></pre>
 <p>A complex parameter using <code>content</code> to define serialization:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;coordinates&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;lat&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;coordinates&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;lat&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;long&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;lat&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          },
-          <span class="hljs-attr">&quot;long&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          }
-        }
-      }
-    }
-  }
-}
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;lat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;long&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1630,7 +1630,7 @@
         <span class="hljs-attr">long:</span>
           <span class="hljs-attr">type:</span> <span class="hljs-string">number</span>
 </code></pre>
-</section></section><section><h3><span id="requestBodyObject">Request Body Object</span></h3>
+<p><a id="requestBodyObject"></a></section></section><section><h3><span>Request Body Object</span></h3></p>
 <p>Describes a single request body.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1650,7 +1650,7 @@
 <tr>
 <td><a id="requestBodyContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="requestBodyRequired"> </a>required</td>
@@ -1663,49 +1663,49 @@
 </section><section><h4>Request Body Examples</h4>
 <p>A request body with a referenced model definition.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User Example&quot;</span>, 
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.json&quot;</span>
-          } 
-        }
-    },
-    <span class="hljs-attr">&quot;application/xml&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in XML&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.xml&quot;</span>
-          }
-        }
-    },
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in Plain text&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.txt&quot;</span> 
-        }
-      } 
-    },
-    <span class="hljs-attr">&quot;*/*&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in other format&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.whatever&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User Example&quot;</span><span class="hljs-punctuation">,</span> 
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.json&quot;</span>
+          <span class="hljs-punctuation">}</span> 
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in XML&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.xml&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in Plain text&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.txt&quot;</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span> 
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in other format&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.whatever&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1737,20 +1737,20 @@
 </code></pre>
 <p>A body parameter that is an array of string values:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1762,7 +1762,7 @@
       <span class="hljs-attr">items:</span>
         <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="mediaTypeObject">Media Type Object</span></h3>
+<p><a id="mediaTypeObject"></a></section></section><section><h3><span>Media Type Object</span></h3></p>
 <p>Each Media Type Object provides schema and examples for the media type identified by its key.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1799,39 +1799,39 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Media Type Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;application/json&quot;</span>: {
-    <span class="hljs-attr">&quot;schema&quot;</span>: {
-         <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-    },
-    <span class="hljs-attr">&quot;examples&quot;</span>: {
-      <span class="hljs-attr">&quot;cat&quot;</span> : {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a cat&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span>: 
-          {
-            <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Fluffy&quot;</span>,
-            <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-            <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;White&quot;</span>,
-            <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;male&quot;</span>,
-            <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Persian&quot;</span>
-          }
-      },
-      <span class="hljs-attr">&quot;dog&quot;</span>: {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span> :  { 
-          <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-          <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Dog&quot;</span>,
-          <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;Black&quot;</span>,
-          <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;Female&quot;</span>,
-          <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Mixed&quot;</span>
-        },
-      <span class="hljs-attr">&quot;frog&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+         <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;cat&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a cat&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span><span class="hljs-punctuation">:</span> 
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Fluffy&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;White&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;male&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Persian&quot;</span>
+          <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span> <span class="hljs-punctuation">:</span>  <span class="hljs-punctuation">{</span> 
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Dog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Black&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Female&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Mixed&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;frog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">application/json:</span> 
@@ -1975,7 +1975,7 @@
               <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Address&#x27;</span>
 </code></pre>
 <p>An <code>encoding</code> attribute is introduced to give you control over the serialization of parts of <code>multipart</code> request bodies.  This attribute is <em>only</em> applicable to <code>multipart</code> and <code>application/x-www-form-urlencoded</code> request bodies.</p>
-</section></section><section><h3><span id="encodingObject">Encoding Object</span></h3>
+<p><a id="encodingObject"></a></section></section><section><h3><span>Encoding Object</span></h3></p>
 <p>A single encoding definition applied to a single schema property.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2050,7 +2050,7 @@
               <span class="hljs-attr">schema:</span>
                 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.</p>
 <p>The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
@@ -2098,28 +2098,28 @@
 </section><section><h4>Responses Object Example</h4>
 <p>A 200 response for a successful operation and a default response for others (implying an error):</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;200&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;a pet to be returned&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;default&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Unexpected error&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;a pet to be returned&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Unexpected error&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">&#x27;200&#x27;:</span>
@@ -2135,7 +2135,7 @@
       <span class="hljs-attr">schema:</span>
         <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation, including design-time, static
 <code>links</code> to operations based on the response.</p>
 <section><h4>Fixed Fields</h4>
@@ -2161,7 +2161,7 @@
 <tr>
 <td><a id="responseContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="responseLinks"> </a>links</td>
@@ -2174,19 +2174,19 @@
 </section><section><h4>Response Object Examples</h4>
 <p>Response of an array of a complex type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A complex object array response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A complex object array response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">complex</span> <span class="hljs-string">object</span> <span class="hljs-string">array</span> <span class="hljs-string">response</span>
@@ -2199,17 +2199,17 @@
 </code></pre>
 <p>Response with a string type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  }
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
 
-}
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2220,37 +2220,37 @@
 </code></pre>
 <p>Plain text response with headers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;example&quot;</span>: <span class="hljs-string">&quot;whoa!&quot;</span>
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;headers&quot;</span>: {
-    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;whoa!&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;headers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2275,14 +2275,14 @@
 </code></pre>
 <p>Response with no return value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;object created&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object created&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="callbackObject">Callback Object</span></h3>
+<p><a id="callbackObject"></a></section></section><section><h3><span>Callback Object</span></h3></p>
 <p>A map of possible out-of band callbacks related to the parent operation.
 Each value in the map is a <a href="#pathItemObject">Path Item Object</a> that describes a set of requests that may be initiated by the API provider and the expected responses.
 The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.</p>
@@ -2317,7 +2317,7 @@
 <span class="hljs-attribute">Content-Type</span><span class="hljs-punctuation">: </span>application/json
 <span class="hljs-attribute">Content-Length</span><span class="hljs-punctuation">: </span>187
 
-<span class="awk">{
+<span class="language-avrasm">{
   <span class="hljs-string">&quot;failedUrl&quot;</span> : <span class="hljs-string">&quot;https://clientdomain.com/failed&quot;</span>,
   <span class="hljs-string">&quot;successUrls&quot;</span> : [
     <span class="hljs-string">&quot;https://clientdomain.com/fast&quot;</span>,
@@ -2327,7 +2327,7 @@
 }
 
 <span class="hljs-number">201</span> Created
-Location: https:<span class="hljs-regexp">//</span>example.org<span class="hljs-regexp">/subscription/</span><span class="hljs-number">1</span>
+<span class="hljs-symbol">Location:</span> https://example<span class="hljs-meta">.org</span>/subscription/<span class="hljs-number">1</span>
 </span></code></pre>
 <p>The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named <code>eventType</code> and a query parameter named <code>queryUrl</code>.</p>
 <table>
@@ -2403,7 +2403,7 @@
         <span class="hljs-attr">&#x27;200&#x27;:</span>
           <span class="hljs-attr">description:</span> <span class="hljs-string">callback</span> <span class="hljs-string">successfully</span> <span class="hljs-string">processed</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <section><h4>Fixed Fields</h4>
 <table>
 <thead>
@@ -2491,7 +2491,7 @@
           <span class="hljs-attr">confirmation-success:</span>
             <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/examples/confirmation-success&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="linkObject">Link Object</span></h3>
+<p><a id="linkObject"></a></section></section><section><h3><span>Link Object</span></h3></p>
 <p>The <code>Link object</code> represents a possible design-time link for a response.
 The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.</p>
 <p>Unlike <em>dynamic</em> links (i.e. links provided <strong>in</strong> the response payload), the OAS linking mechanism does not require link information in the runtime response.</p>
@@ -2625,32 +2625,32 @@
 </code></pre>
 <p>Note that in the use of <code>operationRef</code>, the <em>escaped forward-slash</em> is necessary when
 using JSON references.</p>
-</section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4>
+<p><a id="runtimeExpression"></a></section><section><h4><span>Runtime Expressions</span></h4></p>
 <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call.
 This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p>
-<p>The runtime expression is defined by the following [ABNF] syntax</p>
-<pre class="nohighlight"><code>
-      expression = ( <span class="hljs-string">&quot;$url&quot;</span> / <span class="hljs-string">&quot;$method&quot;</span> / <span class="hljs-string">&quot;$statusCode&quot;</span> / <span class="hljs-string">&quot;$request.&quot;</span> source / <span class="hljs-string">&quot;$response.&quot;</span> source )
-      source = ( header-reference / query-reference / path-reference / body-reference )
-      header-reference = <span class="hljs-string">&quot;header.&quot;</span> token
-      query-reference = <span class="hljs-string">&quot;query.&quot;</span> name  
-      path-reference = <span class="hljs-string">&quot;path.&quot;</span> name
-      body-reference = <span class="hljs-string">&quot;body&quot;</span> [<span class="hljs-string">&quot;#&quot;</span> json-pointer ]
-      json-pointer    = *( <span class="hljs-string">&quot;/&quot;</span> reference-token )
-      reference-token = *( unescaped / escaped )
-      unescaped       = <span class="hljs-symbol">%x00-2E</span> / <span class="hljs-symbol">%x30-7D</span> / <span class="hljs-symbol">%x7F-10FFFF</span>
+<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p>
+<pre class="nohighlight"><code>
+      expression <span class="hljs-operator">=</span> ( <span class="hljs-string">&quot;$url&quot;</span> / <span class="hljs-string">&quot;$method&quot;</span> / <span class="hljs-string">&quot;$statusCode&quot;</span> / <span class="hljs-string">&quot;$request.&quot;</span> source / <span class="hljs-string">&quot;$response.&quot;</span> source )
+      source <span class="hljs-operator">=</span> ( header-reference / query-reference / path-reference / body-reference )
+      header-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;header.&quot;</span> token
+      query-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;query.&quot;</span> name  
+      path-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;path.&quot;</span> name
+      body-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;body&quot;</span> [<span class="hljs-string">&quot;#&quot;</span> json-pointer ]
+      json-pointer    <span class="hljs-operator">=</span> *( <span class="hljs-string">&quot;/&quot;</span> reference-token )
+      reference-token <span class="hljs-operator">=</span> *( unescaped / escaped )
+      unescaped       <span class="hljs-operator">=</span> <span class="hljs-symbol">%x00-2E</span> / <span class="hljs-symbol">%x30-7D</span> / <span class="hljs-symbol">%x7F-10FFFF</span>
          <span class="hljs-comment">; %x2F (&#x27;/&#x27;) and %x7E (&#x27;~&#x27;) are excluded from &#x27;unescaped&#x27;</span>
-      escaped         = <span class="hljs-string">&quot;~&quot;</span> ( <span class="hljs-string">&quot;0&quot;</span> / <span class="hljs-string">&quot;1&quot;</span> )
+      escaped         <span class="hljs-operator">=</span> <span class="hljs-string">&quot;~&quot;</span> ( <span class="hljs-string">&quot;0&quot;</span> / <span class="hljs-string">&quot;1&quot;</span> )
         <span class="hljs-comment">; representing &#x27;~&#x27; and &#x27;/&#x27;, respectively</span>
-      name = *( <span class="hljs-keyword">CHAR</span> )
-      token = <span class="hljs-number">1</span>*tchar
-      tchar = <span class="hljs-string">&quot;!&quot;</span> / <span class="hljs-string">&quot;#&quot;</span> / <span class="hljs-string">&quot;$&quot;</span> / <span class="hljs-string">&quot;%&quot;</span> / <span class="hljs-string">&quot;&amp;&quot;</span> / <span class="hljs-string">&quot;&#x27;&quot;</span> / <span class="hljs-string">&quot;*&quot;</span> / <span class="hljs-string">&quot;+&quot;</span> / <span class="hljs-string">&quot;-&quot;</span> / <span class="hljs-string">&quot;.&quot;</span> /
+      name <span class="hljs-operator">=</span> *( <span class="hljs-keyword">CHAR</span> )
+      token <span class="hljs-operator">=</span> <span class="hljs-number">1</span>*tchar
+      tchar <span class="hljs-operator">=</span> <span class="hljs-string">&quot;!&quot;</span> / <span class="hljs-string">&quot;#&quot;</span> / <span class="hljs-string">&quot;$&quot;</span> / <span class="hljs-string">&quot;%&quot;</span> / <span class="hljs-string">&quot;&amp;&quot;</span> / <span class="hljs-string">&quot;&#x27;&quot;</span> / <span class="hljs-string">&quot;*&quot;</span> / <span class="hljs-string">&quot;+&quot;</span> / <span class="hljs-string">&quot;-&quot;</span> / <span class="hljs-string">&quot;.&quot;</span> /
         <span class="hljs-string">&quot;^&quot;</span> / <span class="hljs-string">&quot;_&quot;</span> / <span class="hljs-string">&quot;`&quot;</span> / <span class="hljs-string">&quot;|&quot;</span> / <span class="hljs-string">&quot;~&quot;</span> / <span class="hljs-keyword">DIGIT</span> / <span class="hljs-keyword">ALPHA</span>
 </code></pre>
 <p>Here, <code>json-pointer</code> is taken from [[!RFC6901]], <code>char</code> from [[!RFC7159]] and <code>token</code> from [[!RFC7230]].</p>
 <p>The <code>name</code> identifier is case-sensitive, whereas <code>token</code> is not.</p>
 <p>The table below provides examples of runtime expressions and examples of their use in a value:</p>
-</section><section><h4><span id="runtimeExpressionExamples">Examples</span></h4>
+<p><a id="runtimeExpressionExamples"></a></section><section><h4><span>Examples</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2699,7 +2699,7 @@
 </table>
 <p>Runtime expressions preserve the type of the referenced value.
 Expressions can be embedded into string values by surrounding the expression with <code>{}</code> curly braces.</p>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <p>The Header Object follows the structure of the <a href="#parameterObject">Parameter Object</a> with the following changes:</p>
 <ol>
 <li><code>name</code> MUST NOT be specified, it is given in the corresponding <code>headers</code> map.</li>
@@ -2709,19 +2709,19 @@
 <section><h4>Header Object Example</h4>
 <p>A simple header of type <code>integer</code>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">schema:</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Adds metadata to a single tag that is used by the <a href="#operationObject">Operation Object</a>.
 It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.</p>
 <section><h4>Fixed Fields</h4>
@@ -2754,16 +2754,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Tag Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;pet&quot;</span>,
-	<span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pets operations&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet&quot;</span><span class="hljs-punctuation">,</span>
+	<span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pets operations&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other components in the OpenAPI document, internally and externally.</p>
 <p>The <code>$ref</code> string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.</p>
 <p>See the rules for resolving <a href="#relativeReferencesURI">Relative References</a>.</p>
@@ -2798,32 +2798,32 @@
 <p>Note that this restriction on additional properties is a difference between Reference Objects and <a href="#schemaObject"><code>Schema Objects</code></a> that contain a <code>$ref</code> keyword.</p>
 </section><section><h4>Reference Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Pet&#x27;</span>
 </code></pre>
 </section><section><h4>Relative Schema Document Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;Pet.json&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet.json&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">Pet.yaml</span>
 </code></pre>
 </section><section><h4>Relative Documents With Embedded Schema Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">definitions.yaml#/Pet</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types.
 These types can be objects, but also primitives and arrays. This object is a superset of the <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00">JSON Schema Specification Draft 2020-12</a>.</p>
 <p>For more information about the properties, see <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00">JSON Schema Core</a> and <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00">JSON Schema Validation</a>.</p>
@@ -2839,7 +2839,7 @@
 </ul>
 <p>In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.</p>
 <p>The OpenAPI Specification’s base vocabulary is comprised of the following keywords:</p>
-</section><section><h4><span id="baseVocabulary">Fixed Fields</span></h4>
+<p><a id="baseVocabulary"></a></section><section><h4><span>Fixed Fields</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2872,7 +2872,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>, though as noted, additional properties MAY omit the <code>x-</code> prefix within this object.</p>
-<section><h5><span id="schemaComposition">Composition and Inheritance (Polymorphism)</span></h5>
+<p><a id="schemaComposition"></a><section><h5><span>Composition and Inheritance (Polymorphism)</span></h5></p>
 <p>The OpenAPI Specification allows combining and extending model definitions using the <code>allOf</code> property of JSON Schema, in effect offering model composition.
 <code>allOf</code> takes an array of object definitions that are validated <em>independently</em> but together compose a single object.</p>
 <p>While composition offers model extensibility, it does not imply a hierarchy between the models.
@@ -2896,10 +2896,10 @@
 </section></section><section><h4>Schema Object Examples</h4>
 <section><h5>Primitive Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-  <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;email&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;email&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
@@ -2907,25 +2907,25 @@
 </code></pre>
 </section><section><h5>Simple Model</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;address&quot;</span>: {
-      <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
-    },
-    <span class="hljs-attr">&quot;age&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-      <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-    }
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;address&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;age&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2944,12 +2944,12 @@
 </section><section><h5>Model with Map/Dictionary Properties</h5>
 <p>For a simple string to string mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2958,12 +2958,12 @@
 </code></pre>
 <p>For a string to model mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2972,25 +2972,25 @@
 </code></pre>
 </section><section><h5>Model with Example</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;id&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    },
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;example&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-    <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">1</span>
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3008,47 +3008,47 @@
 </code></pre>
 </section><section><h5>Models with Composition</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;ErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;message&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;ErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;message&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;code&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;message&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;code&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-            <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">100</span>,
-            <span class="hljs-attr">&quot;maximum&quot;</span>: <span class="hljs-number">600</span>
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">100</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;maximum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">600</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;rootCause&quot;</span>
-            ],
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;rootCause&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;rootCause&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3077,80 +3077,80 @@
 </code></pre>
 </section><section><h5>Models with Polymorphism Support</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;Pet&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;discriminator&quot;</span>: {
-          <span class="hljs-attr">&quot;propertyName&quot;</span>: <span class="hljs-string">&quot;petType&quot;</span>
-        },
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;name&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;petType&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          }
-        },
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;name&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;Pet&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;discriminator&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;propertyName&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petType&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;name&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;petType&quot;</span>
-        ]
-      },
-      <span class="hljs-attr">&quot;Cat&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;huntingSkill&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The measured skill for hunting&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;lazy&quot;</span>,
-                <span class="hljs-attr">&quot;enum&quot;</span>: [
-                  <span class="hljs-string">&quot;clueless&quot;</span>,
-                  <span class="hljs-string">&quot;lazy&quot;</span>,
-                  <span class="hljs-string">&quot;adventurous&quot;</span>,
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Cat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;huntingSkill&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The measured skill for hunting&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+                  <span class="hljs-string">&quot;clueless&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;adventurous&quot;</span><span class="hljs-punctuation">,</span>
                   <span class="hljs-string">&quot;aggressive&quot;</span>
-                ]
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+                <span class="hljs-punctuation">]</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;huntingSkill&quot;</span>
-            ]
-          }
-        ]
-      },
-      <span class="hljs-attr">&quot;Dog&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;packSize&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-                <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-number">0</span>,
-                <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;packSize&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;packSize&quot;</span>
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3198,7 +3198,7 @@
         <span class="hljs-attr">required:</span>
         <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="discriminatorObject">Discriminator Object</span></h3>
+<p><a id="discriminatorObject"></a></section></section></section><section><h3><span>Discriminator Object</span></h3></p>
 <p>When request bodies or response payloads may be one of a number of different schemas, a <code>discriminator</code> object can be used to aid in serialization, deserialization, and validation.  The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.</p>
 <p>When using the discriminator, <em>inline</em> schemas will not be considered.</p>
 <section><h4>Fixed Fields</h4>
@@ -3245,10 +3245,10 @@
 </code></pre>
 <p>The expectation now is that a property with name <code>petType</code> <em>MUST</em> be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document.  Thus the response payload:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">12345</span>,
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">12345</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>Will indicate that the <code>Cat</code> schema be used in conjunction with this payload.</p>
 <p>In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional <code>mapping</code> definition MAY be used:</p>
@@ -3310,20 +3310,20 @@
 </code></pre>
 <p>a payload like this:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;misty&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;misty&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will indicate that the <code>Cat</code> schema be used.  Likewise this schema:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;dog&quot;</span>,
-  <span class="hljs-attr">&quot;bark&quot;</span>: <span class="hljs-string">&quot;soft&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;dog&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bark&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;soft&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will map to <code>Dog</code> because of the definition in the <code>mapping</code> element.</p>
-</section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property SHOULD be used to add that information.
 See examples for expected behavior.</p>
@@ -3370,11 +3370,11 @@
 <section><h5>No XML Element</h5>
 <p>Basic string property:</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3385,14 +3385,14 @@
 </code></pre>
 <p>Basic string array property (<a href="#xmlWrapped"><code>wrapped</code></a> is <code>false</code> by default):</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3407,14 +3407,14 @@
 </code></pre>
 </section><section><h5>XML Name Replacement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3428,27 +3428,27 @@
 </section><section><h5>XML Attribute, Prefix and Namespace</h5>
 <p>In this example, a full model definition is shown.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;Person&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;properties&quot;</span>: {
-      <span class="hljs-attr">&quot;id&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-        <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;attribute&quot;</span>: <span class="hljs-literal">true</span>
-        }
-      },
-      <span class="hljs-attr">&quot;name&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;namespace&quot;</span>: <span class="hljs-string">&quot;https://example.com/schema/sample&quot;</span>,
-          <span class="hljs-attr">&quot;prefix&quot;</span>: <span class="hljs-string">&quot;sample&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;Person&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;attribute&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;namespace&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/schema/sample&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;prefix&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;sample&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">Person:</span>
@@ -3473,17 +3473,17 @@
 </section><section><h5>XML Arrays</h5>
 <p>Changing the element names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3499,20 +3499,20 @@
 </code></pre>
 <p>The external <code>name</code> property has no effect on the XML:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3530,17 +3530,17 @@
 </code></pre>
 <p>Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3558,20 +3558,20 @@
 </code></pre>
 <p>To overcome the naming problem in the example above, the following definition can be used:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3591,21 +3591,21 @@
 </code></pre>
 <p>Affecting both internal and external names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3626,18 +3626,18 @@
 </code></pre>
 <p>If we change the external element but not the internal ones:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3654,7 +3654,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Defines a security scheme that can be used by the operations.</p>
 <p>Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and <a href="https://tools.ietf.org/html/draft-ietf-oauth-discovery-06">OpenID Connect Discovery</a>.
 Please note that as of 2020, the implicit flow is about to be deprecated by <a href="https://tools.ietf.org/html/draft-ietf-oauth-security-topics">OAuth 2.0 Security Best Current Practice</a>. Recommended for most use case is Authorization Code Grant flow with PKCE.</p>
@@ -3723,10 +3723,10 @@
 </section><section><h4>Security Scheme Object Example</h4>
 <section><h5>Basic Authentication Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;basic&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;basic&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3734,11 +3734,11 @@
 </code></pre>
 </section><section><h5>API Key Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;apiKey&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;api_key&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">apiKey</span>
@@ -3747,11 +3747,11 @@
 </code></pre>
 </section><section><h5>JWT Bearer Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;bearer&quot;</span>,
-  <span class="hljs-attr">&quot;bearerFormat&quot;</span>: <span class="hljs-string">&quot;JWT&quot;</span>,
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;bearer&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bearerFormat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;JWT&quot;</span><span class="hljs-punctuation">,</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3760,18 +3760,18 @@
 </code></pre>
 </section><section><h5>Implicit OAuth2 Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3782,7 +3782,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="oauthFlowsObject">OAuth Flows Object</span></h3>
+<p><a id="oauthFlowsObject"></a></section></section></section><section><h3><span>OAuth Flows Object</span></h3></p>
 <p>Allows configuration of the supported OAuth Flows.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3817,7 +3817,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="oauthFlowObject">OAuth Flow Object</span></h3>
+<p><a id="oauthFlowObject"></a></section></section><section><h3><span>OAuth Flow Object</span></h3></p>
 <p>Configuration details for a supported OAuth Flow</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3859,26 +3859,26 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>OAuth Flow Object Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;authorizationCode&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;tokenUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;authorizationCode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;tokenUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3895,7 +3895,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span> 
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation.
 The name used for each property MUST correspond to a security scheme declared in the <a href="#componentsSecuritySchemes">Security Schemes</a> under the <a href="#componentsObject">Components Object</a>.</p>
 <p>Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
@@ -3921,21 +3921,21 @@
 </section><section><h4>Security Requirement Object Examples</h4>
 <section><h5>Non-OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;api_key&quot;</span>: []
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">api_key:</span> []
 </code></pre>
 </section><section><h5>OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-    <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
     <span class="hljs-string">&quot;read:pets&quot;</span>
-  ]
-}
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">petstore_auth:</span>
@@ -3945,17 +3945,17 @@
 </section><section><h5>Optional OAuth2 Security</h5>
 <p>Optional OAuth2 security as would be defined in an <a href="#openapi-object">OpenAPI Object</a> or an <a href="#operation-object">Operation Object</a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {},
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">security:</span>
@@ -3964,7 +3964,7 @@
     <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
     <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="specificationExtensions">Specification Extensions</span></h2>
+<p><a id="specificationExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are implemented as patterned fields that are always prefixed by <code>&quot;x-&quot;</code>.</p>
 <table>
@@ -3984,7 +3984,7 @@
 </tbody>
 </table>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning is to allow an additional layer of access control over the documentation.
 While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
@@ -3993,7 +3993,7 @@
 <li>The <a href="#pathsObject">Paths Object</a> MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the <a href="#infoObject">Info Object</a> which may contain additional information regarding authentication.</li>
 <li>The <a href="#pathItemObject">Path Item Object</a> MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the <a href="#pathsObject">Paths Object</a>, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.</li>
 </ol>
-</section></section><section><h1><span id="revisionHistory">Appendix A: Revision History</span></h1>
+<p><a id="revisionHistory"></a></section></section><section><h1><span>Appendix A: Revision History</span></h1></p>
 <table>
 <thead>
 <tr>
diff --git a/oas/v2.0.html b/oas/v2.0.html
index cfb1c5c857..cb4fd77877 100644
--- a/oas/v2.0.html
+++ b/oas/v2.0.html
@@ -48,9 +48,9 @@
 </tbody>
 </table>
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.</p>
-</section><section><h4><span id="mimeTypes"><dfn>Mime Types</dfn></span></h4>
+<p><a id="mimeTypes"></a></section><section><h4><span><dfn>Mime Types</dfn></span></h4></p>
 <p>Mime type definitions are spread across several resources. The mime type definitions should be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible mime type definitions:</p>
 <pre class="highlight "><code>
@@ -65,7 +65,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation. The available status codes are described by [[!RFC7231]] and in the <a href="http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
 <section><h2>Format</h2>
@@ -149,13 +149,13 @@
 <td>date</td>
 <td><code>string</code></td>
 <td><code>date</code></td>
-<td>As defined by <code>full-date</code> - <a href="http://xml2rfc.ietf.org/public/rfc/html/rfc3339#anchor14">[!RFC3339]</a></td>
+<td>As defined by <code>full-date</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td>dateTime</td>
 <td><code>string</code></td>
 <td><code>date-time</code></td>
-<td>As defined by <code>date-time</code> - <a href="http://xml2rfc.ietf.org/public/rfc/html/rfc3339#anchor14">[!RFC3339]</a></td>
+<td>As defined by <code>date-time</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td>password</td>
@@ -166,7 +166,7 @@
 </tbody>
 </table>
 </section><section><h2>Schema</h2>
-<section><h3><span id="swaggerObject">Swagger Object</span></h3>
+<p><a id="swaggerObject"></a><section><h3><span>Swagger Object</span></h3></p>
 <p>This is the root document object for the API specification. It combines what previously was the Resource Listing and API Declaration (version 1.2 and earlier) together into one document.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -272,7 +272,7 @@
 </tr>
 </tbody>
 </table>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API. The metadata can be used by the clients if needed, and can be presented in the Swagger-UI for convenience.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -364,7 +364,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -423,7 +423,7 @@
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.swagger.io/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@swagger.io</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -475,7 +475,7 @@
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.apache.org/licenses/LICENSE-2.0.html</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints. The path is appended to the <a href="#swaggerBasePath"><code>basePath</code></a> in order to construct the full URL.
 The Paths may be empty, due to <a href="#securityFiltering">ACL constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -538,7 +538,7 @@
           <span class="hljs-attr">items:</span>
             <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/definitions/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item may be empty, due to <a href="#securityFiltering">ACL constraints</a>. The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
 <section><h4>Fixed Fields</h4>
@@ -688,7 +688,7 @@
     <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
   <span class="hljs-attr">collectionFormat:</span> <span class="hljs-string">csv</span>
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -873,7 +873,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -925,7 +925,7 @@
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://swagger.io</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <p>There are five possible parameter types.</p>
@@ -1241,7 +1241,7 @@
 <span class="hljs-attr">required:</span> <span class="hljs-literal">true</span>
 <span class="hljs-attr">type:</span> <span class="hljs-string">file</span>
 </code></pre>
-</section></section></section><section><h3><span id="itemsObject">Items Object</span></h3>
+<p><a id="itemsObject"></a></section></section></section><section><h3><span>Items Object</span></h3></p>
 <p>A limited subset of JSON-Schema’s items object. It is used by parameter definitions that are not located <a href="#parameterIn"><code>in</code></a> <code>&quot;body&quot;</code>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1387,7 +1387,7 @@
   <span class="hljs-attr">minimum:</span> <span class="hljs-number">0</span>
   <span class="hljs-attr">maximum:</span> <span class="hljs-number">63</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation. The container maps a HTTP response code to the expected response. It is not expected from the documentation to necessarily cover all possible HTTP response codes, since they may not be known in advance. However, it is expected from the documentation to cover a successful operation response and any known errors.</p>
 <p>The <code>default</code> can be used as the default response object for all HTTP codes that are not covered individually by the specification.</p>
 <p>The <code>Responses Object</code> MUST contain at least one response code, and it SHOULD be the response for a successful operation call.</p>
@@ -1458,7 +1458,7 @@
   <span class="hljs-attr">schema:</span>
     <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/definitions/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1590,7 +1590,7 @@
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="headersObject">Headers Object</span></h3>
+<p><a id="headersObject"></a></section></section><section><h3><span>Headers Object</span></h3></p>
 <p>Lists the headers that can be sent as part of a response.</p>
 <section><h4>Patterned Fields</h4>
 <table>
@@ -1638,7 +1638,7 @@
   <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">seconds</span> <span class="hljs-string">left</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <p>Allows sharing examples for operation responses.</p>
 <section><h4>Patterned Fields</h4>
 <table>
@@ -1678,7 +1678,7 @@
   <span class="hljs-attr">gender:</span> <span class="hljs-string">Female</span>
   <span class="hljs-attr">breed:</span> <span class="hljs-string">Mixed</span>
 </code></pre>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <table>
 <thead>
 <tr>
@@ -1809,7 +1809,7 @@
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Allows adding meta data to a single tag that is used by the <a href="#operationObject">Operation Object</a>. It is not mandatory to have a Tag Object per tag used there.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1866,7 +1866,7 @@
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other definitions in the specification. It can be used to reference parameters and responses that are defined at the top level for reuse.</p>
 <p>The Reference Object is a <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-02">JSON Reference</a> that uses a <a href="http://tools.ietf.org/html/rfc6901">JSON Pointer</a> as its value. For this specification, only <a href="https://tools.ietf.org/html/draft-zyp-json-schema-04#section-7.2.3">canonical dereferencing</a> is supported.</p>
 <section><h4>Fixed Fields</h4>
@@ -1913,7 +1913,7 @@
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;definitions.yaml#/Pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is based on the <a href="http://json-schema.org/">JSON Schema Specification Draft 4</a> and uses a predefined subset of it. On top of this subset, there are extensions provided by this specification to allow for more complete documentation.</p>
 <p>Further information about the properties can be found in <a href="https://tools.ietf.org/html/draft-zyp-json-schema-04">JSON Schema Core</a> and <a href="https://tools.ietf.org/html/draft-fge-json-schema-validation-00">JSON Schema Validation</a>. Unless stated otherwise, the property definitions follow the JSON Schema specification as referenced here.</p>
 <p>The following properties are taken directly from the JSON Schema definition and follow the same specifications:</p>
@@ -2305,7 +2305,7 @@
       <span class="hljs-attr">required:</span>
       <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property should be used to add that information. See examples for expected behavior.</p>
 <section><h4>Fixed Fields</h4>
@@ -2651,7 +2651,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="definitionsObject">Definitions Object</span></h3>
+<p><a id="definitionsObject"></a></section></section></section><section><h3><span>Definitions Object</span></h3></p>
 <p>An object to hold data types that can be consumed and produced by operations. These data types can be primitives, arrays or models.</p>
 <section><h4>Patterned Fields</h4>
 <table>
@@ -2717,7 +2717,7 @@
     <span class="hljs-attr">name:</span>
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="parametersDefinitionsObject">Parameters Definitions Object</span></h3>
+<p><a id="parametersDefinitionsObject"></a></section></section><section><h3><span>Parameters Definitions Object</span></h3></p>
 <p>An object to hold parameters to be reused across operations. Parameter definitions can be referenced to the ones defined here.</p>
 <p>This does <em>not</em> define global operation parameters.</p>
 <section><h4>Patterned Fields</h4>
@@ -2774,7 +2774,7 @@
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
   <span class="hljs-attr">format:</span> <span class="hljs-string">int32</span>
 </code></pre>
-</section></section><section><h3><span id="responsesDefinitionsObject">Responses Definitions Object</span></h3>
+<p><a id="responsesDefinitionsObject"></a></section></section><section><h3><span>Responses Definitions Object</span></h3></p>
 <p>An object to hold responses to be reused across operations. Response definitions can be referenced to the ones defined here.</p>
 <p>This does <em>not</em> define global operation responses.</p>
 <section><h4>Patterned Fields</h4>
@@ -2821,7 +2821,7 @@
   <span class="hljs-attr">schema:</span>
     <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/definitions/GeneralError&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="securityDefinitionsObject">Security Definitions Object</span></h3>
+<p><a id="securityDefinitionsObject"></a></section></section><section><h3><span>Security Definitions Object</span></h3></p>
 <p>A declaration of the security schemes available to be used in the specification. This does not enforce the security schemes on the operations and only serves to provide the relevant details for each scheme.</p>
 <section><h4>Patterned Fields</h4>
 <table>
@@ -2872,7 +2872,7 @@
     <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
     <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Allows the definition of a security scheme that can be used by the operations. Supported schemes are basic authentication, an API key (either as a header or as a query parameter) and OAuth2’s common flows (implicit, password, application and access code).</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2995,7 +2995,7 @@
   <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
   <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="scopesObject">Scopes Object</span></h3>
+<p><a id="scopesObject"></a></section></section></section><section><h3><span>Scopes Object</span></h3></p>
 <p>Lists the available scopes for an OAuth2 security scheme.</p>
 <section><h4>Patterned Fields</h4>
 <table>
@@ -3042,7 +3042,7 @@
 <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
 <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation. The object can have multiple security schemes declared in it which are all required (that is, there is a logical AND between the schemes).</p>
 <p>The name used for each property MUST correspond to a security scheme declared in the <a href="#securityDefinitionsObject">Security Definitions</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -3086,11 +3086,11 @@
 <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="vendorExtensions">Specification Extensions</span></h2>
+<p><a id="vendorExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the Swagger Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are always prefixed by <code>&quot;x-&quot;</code> and can have any valid JSON format value.</p>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the Swagger specification may be declared and remain empty, or completely be removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning behind it is to allow an additional layer of access control over the documentation itself. While not part of the specification itself, certain libraries may choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
 <p>Two examples for this:</p>
diff --git a/oas/v3.0.0.html b/oas/v3.0.0.html
index e9098e3421..15ff36bf93 100644
--- a/oas/v3.0.0.html
+++ b/oas/v3.0.0.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.0 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "},{"name":"Uri Sarid "}],"formerEditors":[{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2017-07-26T00:00:00.000Z","subtitle":"Version 3.0.0","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.0 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "}],"formerEditors":[{"name":"Uri Sarid "},{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2017-07-26T00:00:00.000Z","subtitle":"Version 3.0.0","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-831873-42"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
@@ -16,11 +16,11 @@
 <p>An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.</p>
 <!-- /TOC -->
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="oasDocument"><dfn>OpenAPI Document</dfn></span></h4>
+<p><a id="oasDocument"></a><section><h4><span><dfn>OpenAPI Document</dfn></span></h4></p>
 <p>A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.</p>
-</section><section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a></section><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.</p>
-</section><section><h4><span id="mediaTypes"><dfn>Media Types</dfn></span></h4>
+<p><a id="mediaTypes"></a></section><section><h4><span><dfn>Media Types</dfn></span></h4></p>
 <p>Media type definitions are spread across several resources.
 The media type definitions SHOULD be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible media type definitions:</p>
@@ -36,7 +36,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation.
 The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the <a href="http://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
@@ -49,9 +49,9 @@
 <p>An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.</p>
 <p>For example, if a field has an array value, the JSON array representation will be used:</p>
 <pre class="nohighlight"><code>
-{
-   <span class="hljs-attr">&quot;field&quot;</span>: [ <span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span> ]
-}
+<span class="hljs-punctuation">{</span>
+   <span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span> <span class="hljs-number">1</span><span class="hljs-punctuation">,</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span> <span class="hljs-number">3</span> <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>All field names in the specification are <strong>case sensitive</strong>.</p>
 <p>The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.</p>
@@ -62,10 +62,10 @@
 <li>Keys used in YAML maps MUST be limited to a scalar string, as defined by the <a href="http://yaml.org/spec/1.2/spec.html#id2802346">YAML Failsafe schema ruleset</a>.</li>
 </ul>
 <p><strong>Note:</strong> While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.</p>
-</section><section><h2><span id="documentStructure">Document Structure</span></h2>
+<p><a id="documentStructure"></a></section><section><h2><span>Document Structure</span></h2></p>
 <p>An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, <code>$ref</code> fields MUST be used in the specification to reference those parts as follows from the <a href="http://json-schema.org">JSON Schema</a> definitions.</p>
 <p>It is RECOMMENDED that the root OpenAPI document be named: <code>openapi.json</code> or <code>openapi.yaml</code>.</p>
-</section><section><h2><span id="dataTypes">Data Types</span></h2>
+<p><a id="dataTypes"></a></section><section><h2><span>Data Types</span></h2></p>
 <p>Primitive data types in the OAS are based on the types supported by the <a href="https://tools.ietf.org/html/draft-wright-json-schema-00#section-4.2">JSON Schema Specification Wright Draft 00</a>.
 Note that <code>integer</code> as a type is also supported and is defined as a JSON number without a fraction or exponent part.
 <code>null</code> is not supported as a type (see <a href="#schemaNullable"><code>nullable</code></a> for an alternative solution).
@@ -138,13 +138,13 @@
 <td>date</td>
 <td><code>string</code></td>
 <td><code>date</code></td>
-<td>As defined by <code>full-date</code> - <a href="http://xml2rfc.ietf.org/public/rfc/html/rfc3339#anchor14">[!RFC3339]</a></td>
+<td>As defined by <code>full-date</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td>dateTime</td>
 <td><code>string</code></td>
 <td><code>date-time</code></td>
-<td>As defined by <code>date-time</code> - <a href="http://xml2rfc.ietf.org/public/rfc/html/rfc3339#anchor14">[!RFC3339]</a></td>
+<td>As defined by <code>date-time</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td>password</td>
@@ -154,16 +154,16 @@
 </tr>
 </tbody>
 </table>
-</section><section><h2><span id="richText">Rich Text Formatting</span></h2>
+<p><a id="richText"></a></section><section><h2><span>Rich Text Formatting</span></h2></p>
 <p>Throughout the specification <code>description</code> fields are noted as supporting CommonMark markdown formatting.
 Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by <a href="http://spec.commonmark.org/0.27/">CommonMark 0.27</a>. Tooling MAY choose to ignore some CommonMark features to address security concerns.</p>
-</section><section><h2><span id="relativeReferences">Relative References in URLs</span></h2>
+<p><a id="relativeReferences"></a></section><section><h2><span>Relative References in URLs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]].
 Relative references are resolved using the URLs defined in the <a href="#serverObject"><code>Server Object</code></a> as a Base URI.</p>
 <p>Relative references used in <code>$ref</code> are processed as per <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a>, using the URL of the current document as the base URI. See also the <a href="#referenceObject">Reference Object</a>.</p>
 </section><section><h2>Schema</h2>
 <p>In the following description, if a field is not explicitly <strong>REQUIRED</strong> or described with a MUST or SHALL, it can be considered OPTIONAL.</p>
-<section><h3><span id="oasObject">OpenAPI Object</span></h3>
+<p><a id="oasObject"></a><section><h3><span>OpenAPI Object</span></h3></p>
 <p>This is the root document object of the <a href="#oasDocument">OpenAPI document</a>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -218,7 +218,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API.
 The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.</p>
 <section><h4>Fixed Fields</h4>
@@ -266,21 +266,21 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Info Object Example:</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;Sample Pet Store App&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span>,
-  <span class="hljs-attr">&quot;termsOfService&quot;</span>: <span class="hljs-string">&quot;http://example.com/terms/&quot;</span>,
-  <span class="hljs-attr">&quot;contact&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-    <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-  },
-  <span class="hljs-attr">&quot;license&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-  },
-  <span class="hljs-attr">&quot;version&quot;</span>: <span class="hljs-string">&quot;1.0.1&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;title&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Sample Pet Store App&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;termsOfService&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/terms/&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;contact&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;license&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;version&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;1.0.1&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">title:</span> <span class="hljs-string">Sample</span> <span class="hljs-string">Pet</span> <span class="hljs-string">Store</span> <span class="hljs-string">App</span>
@@ -295,7 +295,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -327,18 +327,18 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Contact Object Example:</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-  <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">API</span> <span class="hljs-string">Support</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.example.com/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@example.com</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -365,16 +365,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>License Object Example:</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.apache.org/licenses/LICENSE-2.0.html</span>
 </code></pre>
-</section></section><section><h3><span id="serverObject">Server Object</span></h3>
+<p><a id="serverObject"></a></section></section><section><h3><span>Server Object</span></h3></p>
 <p>An object representing a Server.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -407,10 +407,10 @@
 </section><section><h4>Server Object Example</h4>
 <p>A single server would be described as:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://development.gigantic-server.com/v1</span>
@@ -418,22 +418,22 @@
 </code></pre>
 <p>The following shows how multiple servers can be described, for example, at the OpenAPI Object’s <a href="#oasServers"><code>servers</code></a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Staging server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Production server&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Staging server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Production server&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -446,30 +446,30 @@
 </code></pre>
 <p>The following shows how variables can be used for a server configuration:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The production API server&quot;</span>,
-      <span class="hljs-attr">&quot;variables&quot;</span>: {
-        <span class="hljs-attr">&quot;username&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;demo&quot;</span>,
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
-        },
-        <span class="hljs-attr">&quot;port&quot;</span>: {
-          <span class="hljs-attr">&quot;enum&quot;</span>: [
-            <span class="hljs-string">&quot;8443&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The production API server&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;variables&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;username&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;demo&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;port&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+            <span class="hljs-string">&quot;8443&quot;</span><span class="hljs-punctuation">,</span>
             <span class="hljs-string">&quot;443&quot;</span>
-          ],
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;8443&quot;</span>
-        },
-        <span class="hljs-attr">&quot;basePath&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;v2&quot;</span>
-        }
-      }
-    }
-  ]
-}
+          <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;8443&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;basePath&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;v2&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -489,7 +489,7 @@
       <span class="hljs-comment"># open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`</span>
       <span class="hljs-attr">default:</span> <span class="hljs-string">v2</span>
 </code></pre>
-</section></section><section><h3><span id="serverVariableObject">Server Variable Object</span></h3>
+<p><a id="serverVariableObject"></a></section></section><section><h3><span>Server Variable Object</span></h3></p>
 <p>An object representing a Server Variable for server URL template substitution.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -519,7 +519,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="componentsObject">Components Object</span></h3>
+<p><a id="componentsObject"></a></section></section><section><h3><span>Components Object</span></h3></p>
 <p>Holds a set of reusable objects for different aspects of the OAS.
 All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.</p>
 <section><h4>Fixed Fields</h4>
@@ -591,93 +591,93 @@
 </code></pre>
 </section><section><h4>Components Object Example</h4>
 <pre class="nohighlight"><code>
-&quot;components&quot;: {
-  &quot;schemas&quot;: {
-    &quot;Category&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Tag&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    }
-  },
-  &quot;parameters&quot;: {
-    &quot;skipParam&quot;: {
-      &quot;name&quot;: &quot;skip&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;number of items to skip&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot;: {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    },
-    &quot;limitParam&quot;: {
-      &quot;name&quot;: &quot;limit&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;max records to return&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot; : {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    }
-  },
-  &quot;responses&quot;: {
-    &quot;NotFound&quot;: {
-      &quot;description&quot;: &quot;Entity not found.&quot;
-    },
-    &quot;IllegalInput&quot;: {
-      &quot;description&quot;: &quot;Illegal input for operation.&quot;
-    },
-    &quot;GeneralError&quot;: {
-      &quot;description&quot;: &quot;General Error&quot;,
-      &quot;content&quot;: {
-        &quot;application/json&quot;: {
-          &quot;schema&quot;: {
-            &quot;$ref&quot;: &quot;#/components/schemas/GeneralError&quot;
-          }
-        }
-      }
-    }
-  },
-  &quot;securitySchemes&quot;: {
-    &quot;api_key&quot;: {
-      &quot;type&quot;: &quot;apiKey&quot;,
-      &quot;name&quot;: &quot;api_key&quot;,
-      &quot;in&quot;: &quot;header&quot;
-    },
-    &quot;petstore_auth&quot;: {
-      &quot;type&quot;: &quot;oauth2&quot;,
-      &quot;flows&quot;: {
-        &quot;implicit&quot;: {
-          &quot;authorizationUrl&quot;: &quot;http://example.org/api/oauth/dialog&quot;,
-          &quot;scopes&quot;: {
-            &quot;write:pets&quot;: &quot;modify pets in your account&quot;,
-            &quot;read:pets&quot;: &quot;read your pets&quot;
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;Category&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Tag&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;skipParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number of items to skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;limitParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;limit&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;max records to return&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;NotFound&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Entity not found.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;IllegalInput&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Illegal input for operation.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;General Error&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/GeneralError&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;securitySchemes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.org/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -740,7 +740,7 @@
             <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
             <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints and their operations.
 The path is appended to the URL from the <a href="#serverObject"><code>Server Object</code></a> in order to construct the full URL.  The Paths MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -779,28 +779,28 @@
 </code></pre>
 </section><section><h4>Paths Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;/pets&quot;</span>: {
-    <span class="hljs-attr">&quot;get&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span>,
-      <span class="hljs-attr">&quot;responses&quot;</span>: {
-        <span class="hljs-attr">&quot;200&quot;</span>: {          
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A list of pets.&quot;</span>,
-          <span class="hljs-attr">&quot;content&quot;</span>: {
-            <span class="hljs-attr">&quot;application/json&quot;</span>: {
-              <span class="hljs-attr">&quot;schema&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-                <span class="hljs-attr">&quot;items&quot;</span>: {
-                  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;/pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>          
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A list of pets.&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
+                <span class="hljs-punctuation">}</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">/pets:</span>
@@ -816,7 +816,7 @@
               <span class="hljs-attr">items:</span>
                 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.
 The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
@@ -900,53 +900,53 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Path Item Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;get&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns pets based on ID&quot;</span>,
-    <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Find pets by ID&quot;</span>,
-    <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;getPetsById&quot;</span>,
-    <span class="hljs-attr">&quot;responses&quot;</span>: {
-      <span class="hljs-attr">&quot;200&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;pet response&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;*/*&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-              <span class="hljs-attr">&quot;items&quot;</span>: {
-                <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-              }
-            }
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;default&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;error payload&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;text/html&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-            }
-          }
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet to use&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      },
-      <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns pets based on ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find pets by ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;getPetsById&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet response&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;error payload&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;text/html&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet to use&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">get:</span>
@@ -979,7 +979,7 @@
     <span class="hljs-attr">items:</span>
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>  
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1056,68 +1056,68 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Operation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;tags&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;tags&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;pet&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span>,
-  <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;updatePetWithForm&quot;</span>,
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;petId&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  ],
-  <span class="hljs-attr">&quot;requestBody&quot;</span>: {
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-           <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;name&quot;</span>: { 
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated name of the pet&quot;</span>,
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              },
-              <span class="hljs-attr">&quot;status&quot;</span>: {
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated status of the pet&quot;</span>,
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-             }
-           },
-        <span class="hljs-attr">&quot;required&quot;</span>: [<span class="hljs-string">&quot;status&quot;</span>] 
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;responses&quot;</span>: {
-    <span class="hljs-attr">&quot;200&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pet updated.&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    },
-    <span class="hljs-attr">&quot;405&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Invalid input&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;updatePetWithForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petId&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;requestBody&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+           <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span> 
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated name of the pet&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;status&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated status of the pet&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+             <span class="hljs-punctuation">}</span>
+           <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-string">&quot;status&quot;</span><span class="hljs-punctuation">]</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet updated.&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;405&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Invalid input&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">tags:</span>
@@ -1160,7 +1160,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1187,16 +1187,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>External Documentation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Find more info here&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find more info here&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://example.com</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <section><h4>Parameter Locations</h4>
@@ -1481,20 +1481,20 @@
 </section><section><h4>Parameter Object Examples</h4>
 <p>A header parameter with an array of 64 bit integer numbers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;token&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;token to be passed as a header&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token to be passed as a header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">token</span>
@@ -1510,15 +1510,15 @@
 </code></pre>
 <p>A path parameter of a string value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;username&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;username to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">username</span>
@@ -1530,20 +1530,20 @@
 </code></pre>
 <p>An optional query parameter of a string value, allowing multiple values by repeating the query parameter:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of the object to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">false</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>,
-  <span class="hljs-attr">&quot;explode&quot;</span>: <span class="hljs-literal">true</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of the object to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;explode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">id</span>
@@ -1559,17 +1559,17 @@
 </code></pre>
 <p>A free-form query parameter, allowing undefined parameters of a specific type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;freeForm&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-    },
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;freeForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1582,29 +1582,29 @@
 </code></pre>
 <p>A complex parameter using <code>content</code> to define serialization:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;coordinates&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;lat&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;coordinates&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;lat&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;long&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;lat&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          },
-          <span class="hljs-attr">&quot;long&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          }
-        }
-      }
-    }
-  }
-}
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;lat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;long&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1622,7 +1622,7 @@
         <span class="hljs-attr">long:</span>
           <span class="hljs-attr">type:</span> <span class="hljs-string">number</span>
 </code></pre>
-</section></section><section><h3><span id="requestBodyObject">Request Body Object</span></h3>
+<p><a id="requestBodyObject"></a></section></section><section><h3><span>Request Body Object</span></h3></p>
 <p>Describes a single request body.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1642,7 +1642,7 @@
 <tr>
 <td><a id="requestBodyContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="requestBodyRequired"> </a>required</td>
@@ -1655,49 +1655,49 @@
 </section><section><h4>Request Body Examples</h4>
 <p>A request body with a referenced model definition.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User Example&quot;</span>, 
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
-          } 
-        }
-    },
-    <span class="hljs-attr">&quot;application/xml&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in XML&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
-          }
-        }
-    },
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in Plain text&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
-        }
-      } 
-    },
-    <span class="hljs-attr">&quot;*/*&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in other format&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User Example&quot;</span><span class="hljs-punctuation">,</span> 
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
+          <span class="hljs-punctuation">}</span> 
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in XML&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in Plain text&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span> 
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in other format&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1729,19 +1729,19 @@
 </code></pre>
 <p>A body parameter that is an array of string values:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1753,7 +1753,7 @@
       <span class="hljs-attr">items:</span>
         <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="mediaTypeObject">Media Type Object</span></h3>
+<p><a id="mediaTypeObject"></a></section></section><section><h3><span>Media Type Object</span></h3></p>
 <p>Each Media Type Object provides schema and examples for the media type identified by its key.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1963,7 +1963,7 @@
               <span class="hljs-attr">type:</span> <span class="hljs-string">&#x27;#/components/schemas/Address&#x27;</span>
 </code></pre>
 <p>An <code>encoding</code> attribute is introduced to give you control over the serialization of parts of <code>multipart</code> request bodies.  This attribute is <em>only</em> applicable to <code>multipart</code> and <code>application/x-www-form-urlencoded</code> request bodies.</p>
-</section></section><section><h3><span id="encodingObject">Encoding Object</span></h3>
+<p><a id="encodingObject"></a></section></section><section><h3><span>Encoding Object</span></h3></p>
 <p>A single encoding definition applied to a single schema property.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2041,7 +2041,7 @@
               <span class="hljs-attr">schema:</span>
                 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.</p>
 <p>The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
@@ -2088,28 +2088,28 @@
 </section><section><h4>Responses Object Example</h4>
 <p>A 200 response for a successful operation and a default response for others (implying an error):</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;200&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;a pet to be returned&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;default&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Unexpected error&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;a pet to be returned&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Unexpected error&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">&#x27;200&#x27;:</span>
@@ -2125,7 +2125,7 @@
       <span class="hljs-attr">schema:</span>
         <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation, including design-time, static
 <code>links</code> to operations based on the response.</p>
 <section><h4>Fixed Fields</h4>
@@ -2151,7 +2151,7 @@
 <tr>
 <td><a id="responseContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="responseLinks"> </a>links</td>
@@ -2164,19 +2164,19 @@
 </section><section><h4>Response Object Examples</h4>
 <p>Response of an array of a complex type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A complex object array response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A complex object array response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">complex</span> <span class="hljs-string">object</span> <span class="hljs-string">array</span> <span class="hljs-string">response</span>
@@ -2189,17 +2189,17 @@
 </code></pre>
 <p>Response with a string type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  }
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
 
-}
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2210,36 +2210,36 @@
 </code></pre>
 <p>Plain text response with headers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;headers&quot;</span>: {
-    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;headers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2264,14 +2264,14 @@
 </code></pre>
 <p>Response with no return value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;object created&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object created&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="callbackObject">Callback Object</span></h3>
+<p><a id="callbackObject"></a></section></section><section><h3><span>Callback Object</span></h3></p>
 <p>A map of possible out-of band callbacks related to the parent operation.
 Each value in the map is a <a href="#pathItemObject">Path Item Object</a> that describes a set of requests that may be initiated by the API provider and the expected responses.
 The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.</p>
@@ -2305,7 +2305,7 @@
 <span class="hljs-attribute">Content-Type</span><span class="hljs-punctuation">: </span>application/json
 <span class="hljs-attribute">Content-Length</span><span class="hljs-punctuation">: </span>187
 
-<span class="awk">{
+<span class="language-avrasm">{
   <span class="hljs-string">&quot;failedUrl&quot;</span> : <span class="hljs-string">&quot;http://clientdomain.com/failed&quot;</span>,
   <span class="hljs-string">&quot;successUrls&quot;</span> : [
     <span class="hljs-string">&quot;http://clientdomain.com/fast&quot;</span>,
@@ -2315,7 +2315,7 @@
 }
 
 <span class="hljs-number">201</span> Created
-Location: http:<span class="hljs-regexp">//</span>example.org<span class="hljs-regexp">/subscription/</span><span class="hljs-number">1</span>
+<span class="hljs-symbol">Location:</span> http://example<span class="hljs-meta">.org</span>/subscription/<span class="hljs-number">1</span>
 </span></code></pre>
 <p>The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named <code>eventType</code> and a query parameter named <code>queryUrl</code>.</p>
 <table>
@@ -2376,7 +2376,7 @@
         <span class="hljs-attr">&#x27;200&#x27;:</span>
           <span class="hljs-attr">description:</span> <span class="hljs-string">webhook</span> <span class="hljs-string">successfully</span> <span class="hljs-string">processed</span> <span class="hljs-string">and</span> <span class="hljs-literal">no</span> <span class="hljs-string">retries</span> <span class="hljs-string">will</span> <span class="hljs-string">be</span> <span class="hljs-string">performed</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <section><h4>Fixed Fields</h4>
 <table>
 <thead>
@@ -2472,7 +2472,7 @@
             <span class="hljs-attr">confirmation-success:</span>
               <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/examples/confirmation-success&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="linkObject">Link Object</span></h3>
+<p><a id="linkObject"></a></section></section><section><h3><span>Link Object</span></h3></p>
 <p>The <code>Link object</code> represents a possible design-time link for a response.
 The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.</p>
 <p>Unlike <em>dynamic</em> links (i.e. links provided <strong>in</strong> the response payload), the OAS linking mechanism does not require link information in the runtime response.</p>
@@ -2606,10 +2606,10 @@
 </code></pre>
 <p>Note that in the use of <code>operationRef</code>, the <em>escaped forward-slash</em> is necessary when
 using JSON references.</p>
-</section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4>
+<p><a id="runtimeExpression"></a></section><section><h4><span>Runtime Expressions</span></h4></p>
 <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call.
 This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p>
-<p>The runtime expression is defined by the following [ABNF] syntax</p>
+<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p>
 <pre class="highlight "><code>
       expression = ( &quot;$url&quot; | &quot;$method&quot; | &quot;$statusCode&quot; | &quot;$request.&quot; source | &quot;$response.&quot; source )
       source = ( header-reference | query-reference | path-reference | body-reference )  
@@ -2624,7 +2624,7 @@
 </code></pre>
 <p>The <code>name</code> identifier is case-sensitive, whereas <code>token</code> is not.</p>
 <p>The table below provides examples of runtime expressions and examples of their use in a value:</p>
-</section><section><h4><span id="runtimeExpressionExamples">Examples</span></h4>
+<p><a id="runtimeExpressionExamples"></a></section><section><h4><span>Examples</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2673,7 +2673,7 @@
 </table>
 <p>Runtime expressions preserve the type of the referenced value.
 Expressions can be embedded into string values by surrounding the expression with <code>{}</code> curly braces.</p>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <p>The Header Object follows the structure of the <a href="#parameterObject">Parameter Object</a> with the following changes:</p>
 <ol>
 <li><code>name</code> MUST NOT be specified, it is given in the corresponding <code>headers</code> map.</li>
@@ -2683,19 +2683,19 @@
 <section><h4>Header Object Example</h4>
 <p>A simple header of type <code>integer</code>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">schema:</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Adds metadata to a single tag that is used by the <a href="#operationObject">Operation Object</a>.
 It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.</p>
 <section><h4>Fixed Fields</h4>
@@ -2728,16 +2728,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Tag Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;pet&quot;</span>,
-	<span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pets operations&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet&quot;</span><span class="hljs-punctuation">,</span>
+	<span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pets operations&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="examplesObject">Examples Object</span></h3>
+<p><a id="examplesObject"></a></section></section><section><h3><span>Examples Object</span></h3></p>
 <p>In an <code>example</code>, a JSON Reference MAY be used, with the
 explicit restriction that examples having a JSON format with object named
 <code>$ref</code> are not allowed. Therefore, that <code>example</code>, structurally, can be
@@ -2796,7 +2796,7 @@
           <span class="hljs-attr">example:</span>
             <span class="hljs-string">$ref:</span> <span class="hljs-string">http://foo.bar#/examples/address-example.json</span>
 </code></pre>
-</section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other components in the specification, internally and externally.</p>
 <p>The Reference Object is defined by <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a> and follows the same structure, behavior and rules.</p>
 <p>For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.</p>
@@ -2820,32 +2820,32 @@
 <p>This object cannot be extended with additional properties and any properties added SHALL be ignored.</p>
 </section><section><h4>Reference Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Pet&#x27;</span>
 </code></pre>
 </section><section><h4>Relative Schema Document Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;Pet.json&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet.json&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">Pet.yaml</span>
 </code></pre>
 </section><section><h4>Relative Documents With Embedded Schema Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">definitions.yaml#/Pet</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types.
 These types can be objects, but also primitives and arrays.
 This object is an extended subset of the <a href="http://json-schema.org/">JSON Schema Specification Wright Draft 00</a>.</p>
@@ -2941,7 +2941,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-<section><h5><span id="schemaComposition">Composition and Inheritance (Polymorphism)</span></h5>
+<p><a id="schemaComposition"></a><section><h5><span>Composition and Inheritance (Polymorphism)</span></h5></p>
 <p>The OpenAPI Specification allows combining and extending model definitions using the <code>allOf</code> property of JSON Schema, in effect offering model composition.
 <code>allOf</code> takes an array of object definitions that are validated <em>independently</em> but together compose a single object.</p>
 <p>While composition offers model extensibility, it does not imply a hierarchy between the models.
@@ -2960,10 +2960,10 @@
 </section></section><section><h4>Schema Object Examples</h4>
 <section><h5>Primitive Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-  <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;email&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;email&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
@@ -2971,25 +2971,25 @@
 </code></pre>
 </section><section><h5>Simple Model</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;address&quot;</span>: {
-      <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
-    },
-    <span class="hljs-attr">&quot;age&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-      <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-    }
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;address&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;age&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3008,12 +3008,12 @@
 </section><section><h5>Model with Map/Dictionary Properties</h5>
 <p>For a simple string to string mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3022,12 +3022,12 @@
 </code></pre>
 <p>For a string to model mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3036,25 +3036,25 @@
 </code></pre>
 </section><section><h5>Model with Example</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;id&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    },
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;example&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-    <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">1</span>
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3072,47 +3072,47 @@
 </code></pre>
 </section><section><h5>Models with Composition</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;ErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;message&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;ErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;message&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;code&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;message&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;code&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-            <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">100</span>,
-            <span class="hljs-attr">&quot;maximum&quot;</span>: <span class="hljs-number">600</span>
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">100</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;maximum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">600</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;rootCause&quot;</span>
-            ],
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;rootCause&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;rootCause&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3141,80 +3141,80 @@
 </code></pre>
 </section><section><h5>Models with Polymorphism Support</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;Pet&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;discriminator&quot;</span>: {
-          <span class="hljs-attr">&quot;propertyName&quot;</span>: <span class="hljs-string">&quot;petType&quot;</span>
-        },
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;name&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;petType&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          }
-        },
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;name&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;Pet&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;discriminator&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;propertyName&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petType&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;name&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;petType&quot;</span>
-        ]
-      },
-      <span class="hljs-attr">&quot;Cat&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;huntingSkill&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The measured skill for hunting&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;lazy&quot;</span>,
-                <span class="hljs-attr">&quot;enum&quot;</span>: [
-                  <span class="hljs-string">&quot;clueless&quot;</span>,
-                  <span class="hljs-string">&quot;lazy&quot;</span>,
-                  <span class="hljs-string">&quot;adventurous&quot;</span>,
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Cat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;huntingSkill&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The measured skill for hunting&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+                  <span class="hljs-string">&quot;clueless&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;adventurous&quot;</span><span class="hljs-punctuation">,</span>
                   <span class="hljs-string">&quot;aggressive&quot;</span>
-                ]
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+                <span class="hljs-punctuation">]</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;huntingSkill&quot;</span>
-            ]
-          }
-        ]
-      },
-      <span class="hljs-attr">&quot;Dog&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;packSize&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-                <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-number">0</span>,
-                <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;packSize&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;packSize&quot;</span>
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3262,7 +3262,7 @@
         <span class="hljs-attr">required:</span>
         <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="discriminatorObject">Discriminator Object</span></h3>
+<p><a id="discriminatorObject"></a></section></section></section><section><h3><span>Discriminator Object</span></h3></p>
 <p>When request bodies or response payloads may be one of a number of different schemas, a <code>discriminator</code> object can be used to aid in serialization, deserialization, and validation.  The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.</p>
 <p>When using the discriminator, <em>inline</em> schemas will not be considered.</p>
 <section><h4>Fixed Fields</h4>
@@ -3386,7 +3386,7 @@
 }
 </code></pre>
 <p>will map to <code>Dog</code> because of the definition in the <code>mappings</code> element.</p>
-</section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property SHOULD be used to add that information.
 See examples for expected behavior.</p>
@@ -3433,11 +3433,11 @@
 <section><h5>No XML Element</h5>
 <p>Basic string property:</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3448,14 +3448,14 @@
 </code></pre>
 <p>Basic string array property (<a href="#xmlWrapped"><code>wrapped</code></a> is <code>false</code> by default):</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3470,14 +3470,14 @@
 </code></pre>
 </section><section><h5>XML Name Replacement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3491,27 +3491,27 @@
 </section><section><h5>XML Attribute, Prefix and Namespace</h5>
 <p>In this example, a full model definition is shown.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;Person&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;properties&quot;</span>: {
-      <span class="hljs-attr">&quot;id&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-        <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;attribute&quot;</span>: <span class="hljs-literal">true</span>
-        }
-      },
-      <span class="hljs-attr">&quot;name&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;namespace&quot;</span>: <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span>,
-          <span class="hljs-attr">&quot;prefix&quot;</span>: <span class="hljs-string">&quot;sample&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;Person&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;attribute&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;namespace&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;prefix&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;sample&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">Person:</span>
@@ -3536,17 +3536,17 @@
 </section><section><h5>XML Arrays</h5>
 <p>Changing the element names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3562,20 +3562,20 @@
 </code></pre>
 <p>The external <code>name</code> property has no effect on the XML:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3593,17 +3593,17 @@
 </code></pre>
 <p>Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3621,20 +3621,20 @@
 </code></pre>
 <p>To overcome the naming problem in the example above, the following definition can be used:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3654,21 +3654,21 @@
 </code></pre>
 <p>Affecting both internal and external names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3689,18 +3689,18 @@
 </code></pre>
 <p>If we change the external element but not the internal ones:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3717,7 +3717,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Defines a security scheme that can be used by the operations.
 Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and <a href="https://tools.ietf.org/html/draft-ietf-oauth-discovery-06">OpenID Connect Discovery</a>.</p>
 <section><h4>Fixed Fields</h4>
@@ -3785,10 +3785,10 @@
 </section><section><h4>Security Scheme Object Example</h4>
 <section><h5>Basic Authentication Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;basic&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;basic&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3796,11 +3796,11 @@
 </code></pre>
 </section><section><h5>API Key Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;apiKey&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;api_key&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">apiKey</span>
@@ -3809,11 +3809,11 @@
 </code></pre>
 </section><section><h5>JWT Bearer Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;bearer&quot;</span>,
-  <span class="hljs-attr">&quot;bearerFormat&quot;</span>: <span class="hljs-string">&quot;JWT&quot;</span>,
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;bearer&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bearerFormat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;JWT&quot;</span><span class="hljs-punctuation">,</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3822,18 +3822,18 @@
 </code></pre>
 </section><section><h5>Implicit OAuth2 Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3844,7 +3844,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="oauthFlowsObject">OAuth Flows Object</span></h3>
+<p><a id="oauthFlowsObject"></a></section></section></section><section><h3><span>OAuth Flows Object</span></h3></p>
 <p>Allows configuration of the supported OAuth Flows.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3879,7 +3879,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="oauthFlowObject">OAuth Flow Object</span></h3>
+<p><a id="oauthFlowObject"></a></section></section><section><h3><span>OAuth Flow Object</span></h3></p>
 <p>Configuration details for a supported OAuth Flow</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3921,26 +3921,26 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>OAuth Flow Object Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;authorizationCode&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;tokenUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;authorizationCode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;tokenUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3957,7 +3957,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span> 
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation.
 The name used for each property MUST correspond to a security scheme declared in the <a href="#componentsSecuritySchemes">Security Schemes</a> under the <a href="#componentsObject">Components Object</a>.</p>
 <p>Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
@@ -3983,28 +3983,28 @@
 </section><section><h4>Security Requirement Object Examples</h4>
 <section><h5>Non-OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;api_key&quot;</span>: []
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">api_key:</span> []
 </code></pre>
 </section><section><h5>OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-    <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
     <span class="hljs-string">&quot;read:pets&quot;</span>
-  ]
-}
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">petstore_auth:</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="specificationExtensions">Specification Extensions</span></h2>
+<p><a id="specificationExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are implemented as patterned fields that are always prefixed by <code>&quot;x-&quot;</code>.</p>
 <table>
@@ -4024,7 +4024,7 @@
 </tbody>
 </table>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning is to allow an additional layer of access control over the documentation.
 While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
@@ -4033,7 +4033,7 @@
 <li>The <a href="#pathsObject">Paths Object</a> MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the <a href="#infoObject">Info Object</a> which may contain additional information regarding authentication.</li>
 <li>The <a href="#pathItemObject">Path Item Object</a> MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the <a href="#pathsObject">Paths Object</a>, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.</li>
 </ol>
-</section></section><section><h1><span id="revisionHistory">Appendix A: Revision History</span></h1>
+<p><a id="revisionHistory"></a></section></section><section><h1><span>Appendix A: Revision History</span></h1></p>
 <table>
 <thead>
 <tr>
diff --git a/oas/v3.0.1.html b/oas/v3.0.1.html
index 8bfef16b4c..0caa0415ba 100644
--- a/oas/v3.0.1.html
+++ b/oas/v3.0.1.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.1 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "},{"name":"Uri Sarid "}],"formerEditors":[{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2017-12-06T00:00:00.000Z","subtitle":"Version 3.0.1","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.1 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "}],"formerEditors":[{"name":"Uri Sarid "},{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2017-12-06T00:00:00.000Z","subtitle":"Version 3.0.1","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-831873-42"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
@@ -16,11 +16,11 @@
 <p>An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.</p>
 <!-- /TOC -->
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="oasDocument"><dfn>OpenAPI Document</dfn></span></h4>
+<p><a id="oasDocument"></a><section><h4><span><dfn>OpenAPI Document</dfn></span></h4></p>
 <p>A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.</p>
-</section><section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a></section><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.</p>
-</section><section><h4><span id="mediaTypes"><dfn>Media Types</dfn></span></h4>
+<p><a id="mediaTypes"></a></section><section><h4><span><dfn>Media Types</dfn></span></h4></p>
 <p>Media type definitions are spread across several resources.
 The media type definitions SHOULD be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible media type definitions:</p>
@@ -36,7 +36,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation.
 The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the <a href="https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
@@ -49,9 +49,9 @@
 <p>An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.</p>
 <p>For example, if a field has an array value, the JSON array representation will be used:</p>
 <pre class="nohighlight"><code>
-{
-   <span class="hljs-attr">&quot;field&quot;</span>: [ <span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span> ]
-}
+<span class="hljs-punctuation">{</span>
+   <span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span> <span class="hljs-number">1</span><span class="hljs-punctuation">,</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span> <span class="hljs-number">3</span> <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>All field names in the specification are <strong>case sensitive</strong>.</p>
 <p>The schema exposes two types of fields: Fixed fields, which have a declared name, and Patterned fields, which declare a regex pattern for the field name.</p>
@@ -62,10 +62,10 @@
 <li>Keys used in YAML maps MUST be limited to a scalar string, as defined by the <a href="http://yaml.org/spec/1.2/spec.html#id2802346">YAML Failsafe schema ruleset</a>.</li>
 </ul>
 <p><strong>Note:</strong> While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.</p>
-</section><section><h2><span id="documentStructure">Document Structure</span></h2>
+<p><a id="documentStructure"></a></section><section><h2><span>Document Structure</span></h2></p>
 <p>An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, <code>$ref</code> fields MUST be used in the specification to reference those parts as follows from the <a href="http://json-schema.org">JSON Schema</a> definitions.</p>
 <p>It is RECOMMENDED that the root OpenAPI document be named: <code>openapi.json</code> or <code>openapi.yaml</code>.</p>
-</section><section><h2><span id="dataTypes">Data Types</span></h2>
+<p><a id="dataTypes"></a></section><section><h2><span>Data Types</span></h2></p>
 <p>Primitive data types in the OAS are based on the types supported by the <a href="https://tools.ietf.org/html/draft-wright-json-schema-00#section-4.2">JSON Schema Specification Wright Draft 00</a>.
 Note that <code>integer</code> as a type is also supported and is defined as a JSON number without a fraction or exponent part.
 <code>null</code> is not supported as a type (see <a href="#schemaNullable"><code>nullable</code></a> for an alternative solution).
@@ -138,13 +138,13 @@
 <td>date</td>
 <td><code>string</code></td>
 <td><code>date</code></td>
-<td>As defined by <code>full-date</code> - [[!RFC3339]]</td>
+<td>As defined by <code>full-date</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td>dateTime</td>
 <td><code>string</code></td>
 <td><code>date-time</code></td>
-<td>As defined by <code>date-time</code> - [[!RFC3339]]</td>
+<td>As defined by <code>date-time</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td>password</td>
@@ -154,16 +154,16 @@
 </tr>
 </tbody>
 </table>
-</section><section><h2><span id="richText">Rich Text Formatting</span></h2>
+<p><a id="richText"></a></section><section><h2><span>Rich Text Formatting</span></h2></p>
 <p>Throughout the specification <code>description</code> fields are noted as supporting CommonMark markdown formatting.
 Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by <a href="http://spec.commonmark.org/0.27/">CommonMark 0.27</a>. Tooling MAY choose to ignore some CommonMark features to address security concerns.</p>
-</section><section><h2><span id="relativeReferences">Relative References in URLs</span></h2>
+<p><a id="relativeReferences"></a></section><section><h2><span>Relative References in URLs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]].
 Relative references are resolved using the URLs defined in the <a href="#serverObject"><code>Server Object</code></a> as a Base URI.</p>
 <p>Relative references used in <code>$ref</code> are processed as per <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a>, using the URL of the current document as the base URI. See also the <a href="#referenceObject">Reference Object</a>.</p>
 </section><section><h2>Schema</h2>
 <p>In the following description, if a field is not explicitly <strong>REQUIRED</strong> or described with a MUST or SHALL, it can be considered OPTIONAL.</p>
-<section><h3><span id="oasObject">OpenAPI Object</span></h3>
+<p><a id="oasObject"></a><section><h3><span>OpenAPI Object</span></h3></p>
 <p>This is the root document object of the <a href="#oasDocument">OpenAPI document</a>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -218,7 +218,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API.
 The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.</p>
 <section><h4>Fixed Fields</h4>
@@ -266,21 +266,21 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Info Object Example:</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;Sample Pet Store App&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span>,
-  <span class="hljs-attr">&quot;termsOfService&quot;</span>: <span class="hljs-string">&quot;http://example.com/terms/&quot;</span>,
-  <span class="hljs-attr">&quot;contact&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-    <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-  },
-  <span class="hljs-attr">&quot;license&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-  },
-  <span class="hljs-attr">&quot;version&quot;</span>: <span class="hljs-string">&quot;1.0.1&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;title&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Sample Pet Store App&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;termsOfService&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/terms/&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;contact&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;license&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;version&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;1.0.1&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">title:</span> <span class="hljs-string">Sample</span> <span class="hljs-string">Pet</span> <span class="hljs-string">Store</span> <span class="hljs-string">App</span>
@@ -295,7 +295,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -327,18 +327,18 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Contact Object Example:</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-  <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">API</span> <span class="hljs-string">Support</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.example.com/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@example.com</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -365,16 +365,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>License Object Example:</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 </code></pre>
-</section></section><section><h3><span id="serverObject">Server Object</span></h3>
+<p><a id="serverObject"></a></section></section><section><h3><span>Server Object</span></h3></p>
 <p>An object representing a Server.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -407,10 +407,10 @@
 </section><section><h4>Server Object Example</h4>
 <p>A single server would be described as:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://development.gigantic-server.com/v1</span>
@@ -418,22 +418,22 @@
 </code></pre>
 <p>The following shows how multiple servers can be described, for example, at the OpenAPI Object’s <a href="#oasServers"><code>servers</code></a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Staging server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Production server&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Staging server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Production server&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -446,30 +446,30 @@
 </code></pre>
 <p>The following shows how variables can be used for a server configuration:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The production API server&quot;</span>,
-      <span class="hljs-attr">&quot;variables&quot;</span>: {
-        <span class="hljs-attr">&quot;username&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;demo&quot;</span>,
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
-        },
-        <span class="hljs-attr">&quot;port&quot;</span>: {
-          <span class="hljs-attr">&quot;enum&quot;</span>: [
-            <span class="hljs-string">&quot;8443&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The production API server&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;variables&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;username&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;demo&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;port&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+            <span class="hljs-string">&quot;8443&quot;</span><span class="hljs-punctuation">,</span>
             <span class="hljs-string">&quot;443&quot;</span>
-          ],
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;8443&quot;</span>
-        },
-        <span class="hljs-attr">&quot;basePath&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;v2&quot;</span>
-        }
-      }
-    }
-  ]
-}
+          <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;8443&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;basePath&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;v2&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -489,7 +489,7 @@
       <span class="hljs-comment"># open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`</span>
       <span class="hljs-attr">default:</span> <span class="hljs-string">v2</span>
 </code></pre>
-</section></section><section><h3><span id="serverVariableObject">Server Variable Object</span></h3>
+<p><a id="serverVariableObject"></a></section></section><section><h3><span>Server Variable Object</span></h3></p>
 <p>An object representing a Server Variable for server URL template substitution.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -519,7 +519,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="componentsObject">Components Object</span></h3>
+<p><a id="componentsObject"></a></section></section><section><h3><span>Components Object</span></h3></p>
 <p>Holds a set of reusable objects for different aspects of the OAS.
 All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.</p>
 <section><h4>Fixed Fields</h4>
@@ -591,93 +591,93 @@
 </code></pre>
 </section><section><h4>Components Object Example</h4>
 <pre class="nohighlight"><code>
-&quot;components&quot;: {
-  &quot;schemas&quot;: {
-    &quot;Category&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Tag&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    }
-  },
-  &quot;parameters&quot;: {
-    &quot;skipParam&quot;: {
-      &quot;name&quot;: &quot;skip&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;number of items to skip&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot;: {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    },
-    &quot;limitParam&quot;: {
-      &quot;name&quot;: &quot;limit&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;max records to return&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot; : {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    }
-  },
-  &quot;responses&quot;: {
-    &quot;NotFound&quot;: {
-      &quot;description&quot;: &quot;Entity not found.&quot;
-    },
-    &quot;IllegalInput&quot;: {
-      &quot;description&quot;: &quot;Illegal input for operation.&quot;
-    },
-    &quot;GeneralError&quot;: {
-      &quot;description&quot;: &quot;General Error&quot;,
-      &quot;content&quot;: {
-        &quot;application/json&quot;: {
-          &quot;schema&quot;: {
-            &quot;$ref&quot;: &quot;#/components/schemas/GeneralError&quot;
-          }
-        }
-      }
-    }
-  },
-  &quot;securitySchemes&quot;: {
-    &quot;api_key&quot;: {
-      &quot;type&quot;: &quot;apiKey&quot;,
-      &quot;name&quot;: &quot;api_key&quot;,
-      &quot;in&quot;: &quot;header&quot;
-    },
-    &quot;petstore_auth&quot;: {
-      &quot;type&quot;: &quot;oauth2&quot;,
-      &quot;flows&quot;: {
-        &quot;implicit&quot;: {
-          &quot;authorizationUrl&quot;: &quot;http://example.org/api/oauth/dialog&quot;,
-          &quot;scopes&quot;: {
-            &quot;write:pets&quot;: &quot;modify pets in your account&quot;,
-            &quot;read:pets&quot;: &quot;read your pets&quot;
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;Category&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Tag&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;skipParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number of items to skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;limitParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;limit&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;max records to return&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;NotFound&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Entity not found.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;IllegalInput&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Illegal input for operation.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;General Error&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/GeneralError&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;securitySchemes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.org/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -740,7 +740,7 @@
             <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
             <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints and their operations.
 The path is appended to the URL from the <a href="#serverObject"><code>Server Object</code></a> in order to construct the full URL.  The Paths MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -779,28 +779,28 @@
 </code></pre>
 </section><section><h4>Paths Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;/pets&quot;</span>: {
-    <span class="hljs-attr">&quot;get&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span>,
-      <span class="hljs-attr">&quot;responses&quot;</span>: {
-        <span class="hljs-attr">&quot;200&quot;</span>: {          
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A list of pets.&quot;</span>,
-          <span class="hljs-attr">&quot;content&quot;</span>: {
-            <span class="hljs-attr">&quot;application/json&quot;</span>: {
-              <span class="hljs-attr">&quot;schema&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-                <span class="hljs-attr">&quot;items&quot;</span>: {
-                  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;/pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>          
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A list of pets.&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
+                <span class="hljs-punctuation">}</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">/pets:</span>
@@ -816,7 +816,7 @@
               <span class="hljs-attr">items:</span>
                 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.
 The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
@@ -900,53 +900,53 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Path Item Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;get&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns pets based on ID&quot;</span>,
-    <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Find pets by ID&quot;</span>,
-    <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;getPetsById&quot;</span>,
-    <span class="hljs-attr">&quot;responses&quot;</span>: {
-      <span class="hljs-attr">&quot;200&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;pet response&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;*/*&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-              <span class="hljs-attr">&quot;items&quot;</span>: {
-                <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-              }
-            }
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;default&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;error payload&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;text/html&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-            }
-          }
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet to use&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      },
-      <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns pets based on ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find pets by ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;getPetsById&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet response&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;error payload&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;text/html&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet to use&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">get:</span>
@@ -979,7 +979,7 @@
     <span class="hljs-attr">items:</span>
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>  
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1056,68 +1056,68 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Operation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;tags&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;tags&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;pet&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span>,
-  <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;updatePetWithForm&quot;</span>,
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;petId&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  ],
-  <span class="hljs-attr">&quot;requestBody&quot;</span>: {
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-           <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;name&quot;</span>: { 
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated name of the pet&quot;</span>,
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              },
-              <span class="hljs-attr">&quot;status&quot;</span>: {
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated status of the pet&quot;</span>,
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-             }
-           },
-        <span class="hljs-attr">&quot;required&quot;</span>: [<span class="hljs-string">&quot;status&quot;</span>] 
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;responses&quot;</span>: {
-    <span class="hljs-attr">&quot;200&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pet updated.&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    },
-    <span class="hljs-attr">&quot;405&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Invalid input&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;updatePetWithForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petId&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;requestBody&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+           <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span> 
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated name of the pet&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;status&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated status of the pet&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+             <span class="hljs-punctuation">}</span>
+           <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-string">&quot;status&quot;</span><span class="hljs-punctuation">]</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet updated.&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;405&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Invalid input&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">tags:</span>
@@ -1160,7 +1160,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1187,16 +1187,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>External Documentation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Find more info here&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find more info here&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://example.com</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <section><h4>Parameter Locations</h4>
@@ -1481,20 +1481,20 @@
 </section><section><h4>Parameter Object Examples</h4>
 <p>A header parameter with an array of 64 bit integer numbers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;token&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;token to be passed as a header&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token to be passed as a header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">token</span>
@@ -1510,15 +1510,15 @@
 </code></pre>
 <p>A path parameter of a string value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;username&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;username to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">username</span>
@@ -1530,20 +1530,20 @@
 </code></pre>
 <p>An optional query parameter of a string value, allowing multiple values by repeating the query parameter:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of the object to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">false</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>,
-  <span class="hljs-attr">&quot;explode&quot;</span>: <span class="hljs-literal">true</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of the object to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;explode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">id</span>
@@ -1559,17 +1559,17 @@
 </code></pre>
 <p>A free-form query parameter, allowing undefined parameters of a specific type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;freeForm&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-    },
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;freeForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1582,29 +1582,29 @@
 </code></pre>
 <p>A complex parameter using <code>content</code> to define serialization:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;coordinates&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;lat&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;coordinates&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;lat&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;long&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;lat&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          },
-          <span class="hljs-attr">&quot;long&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          }
-        }
-      }
-    }
-  }
-}
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;lat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;long&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1622,7 +1622,7 @@
         <span class="hljs-attr">long:</span>
           <span class="hljs-attr">type:</span> <span class="hljs-string">number</span>
 </code></pre>
-</section></section><section><h3><span id="requestBodyObject">Request Body Object</span></h3>
+<p><a id="requestBodyObject"></a></section></section><section><h3><span>Request Body Object</span></h3></p>
 <p>Describes a single request body.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1642,7 +1642,7 @@
 <tr>
 <td><a id="requestBodyContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="requestBodyRequired"> </a>required</td>
@@ -1655,49 +1655,49 @@
 </section><section><h4>Request Body Examples</h4>
 <p>A request body with a referenced model definition.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User Example&quot;</span>, 
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
-          } 
-        }
-    },
-    <span class="hljs-attr">&quot;application/xml&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in XML&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
-          }
-        }
-    },
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in Plain text&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
-        }
-      } 
-    },
-    <span class="hljs-attr">&quot;*/*&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in other format&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User Example&quot;</span><span class="hljs-punctuation">,</span> 
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
+          <span class="hljs-punctuation">}</span> 
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in XML&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in Plain text&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span> 
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in other format&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1729,19 +1729,19 @@
 </code></pre>
 <p>A body parameter that is an array of string values:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1753,7 +1753,7 @@
       <span class="hljs-attr">items:</span>
         <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="mediaTypeObject">Media Type Object</span></h3>
+<p><a id="mediaTypeObject"></a></section></section><section><h3><span>Media Type Object</span></h3></p>
 <p>Each Media Type Object provides schema and examples for the media type identified by its key.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1963,7 +1963,7 @@
               <span class="hljs-attr">type:</span> <span class="hljs-string">&#x27;#/components/schemas/Address&#x27;</span>
 </code></pre>
 <p>An <code>encoding</code> attribute is introduced to give you control over the serialization of parts of <code>multipart</code> request bodies.  This attribute is <em>only</em> applicable to <code>multipart</code> and <code>application/x-www-form-urlencoded</code> request bodies.</p>
-</section></section><section><h3><span id="encodingObject">Encoding Object</span></h3>
+<p><a id="encodingObject"></a></section></section><section><h3><span>Encoding Object</span></h3></p>
 <p>A single encoding definition applied to a single schema property.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2041,7 +2041,7 @@
               <span class="hljs-attr">schema:</span>
                 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.</p>
 <p>The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
@@ -2088,28 +2088,28 @@
 </section><section><h4>Responses Object Example</h4>
 <p>A 200 response for a successful operation and a default response for others (implying an error):</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;200&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;a pet to be returned&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;default&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Unexpected error&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;a pet to be returned&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Unexpected error&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">&#x27;200&#x27;:</span>
@@ -2125,7 +2125,7 @@
       <span class="hljs-attr">schema:</span>
         <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation, including design-time, static
 <code>links</code> to operations based on the response.</p>
 <section><h4>Fixed Fields</h4>
@@ -2151,7 +2151,7 @@
 <tr>
 <td><a id="responseContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="responseLinks"> </a>links</td>
@@ -2164,19 +2164,19 @@
 </section><section><h4>Response Object Examples</h4>
 <p>Response of an array of a complex type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A complex object array response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A complex object array response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">complex</span> <span class="hljs-string">object</span> <span class="hljs-string">array</span> <span class="hljs-string">response</span>
@@ -2189,17 +2189,17 @@
 </code></pre>
 <p>Response with a string type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  }
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
 
-}
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2210,36 +2210,36 @@
 </code></pre>
 <p>Plain text response with headers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;headers&quot;</span>: {
-    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;headers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2264,14 +2264,14 @@
 </code></pre>
 <p>Response with no return value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;object created&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object created&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="callbackObject">Callback Object</span></h3>
+<p><a id="callbackObject"></a></section></section><section><h3><span>Callback Object</span></h3></p>
 <p>A map of possible out-of band callbacks related to the parent operation.
 Each value in the map is a <a href="#pathItemObject">Path Item Object</a> that describes a set of requests that may be initiated by the API provider and the expected responses.
 The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.</p>
@@ -2305,7 +2305,7 @@
 <span class="hljs-attribute">Content-Type</span><span class="hljs-punctuation">: </span>application/json
 <span class="hljs-attribute">Content-Length</span><span class="hljs-punctuation">: </span>187
 
-<span class="awk">{
+<span class="language-avrasm">{
   <span class="hljs-string">&quot;failedUrl&quot;</span> : <span class="hljs-string">&quot;http://clientdomain.com/failed&quot;</span>,
   <span class="hljs-string">&quot;successUrls&quot;</span> : [
     <span class="hljs-string">&quot;http://clientdomain.com/fast&quot;</span>,
@@ -2315,7 +2315,7 @@
 }
 
 <span class="hljs-number">201</span> Created
-Location: http:<span class="hljs-regexp">//</span>example.org<span class="hljs-regexp">/subscription/</span><span class="hljs-number">1</span>
+<span class="hljs-symbol">Location:</span> http://example<span class="hljs-meta">.org</span>/subscription/<span class="hljs-number">1</span>
 </span></code></pre>
 <p>The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named <code>eventType</code> and a query parameter named <code>queryUrl</code>.</p>
 <table>
@@ -2376,7 +2376,7 @@
         <span class="hljs-attr">&#x27;200&#x27;:</span>
           <span class="hljs-attr">description:</span> <span class="hljs-string">webhook</span> <span class="hljs-string">successfully</span> <span class="hljs-string">processed</span> <span class="hljs-string">and</span> <span class="hljs-literal">no</span> <span class="hljs-string">retries</span> <span class="hljs-string">will</span> <span class="hljs-string">be</span> <span class="hljs-string">performed</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <section><h4>Fixed Fields</h4>
 <table>
 <thead>
@@ -2472,7 +2472,7 @@
             <span class="hljs-attr">confirmation-success:</span>
               <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/examples/confirmation-success&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="linkObject">Link Object</span></h3>
+<p><a id="linkObject"></a></section></section><section><h3><span>Link Object</span></h3></p>
 <p>The <code>Link object</code> represents a possible design-time link for a response.
 The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.</p>
 <p>Unlike <em>dynamic</em> links (i.e. links provided <strong>in</strong> the response payload), the OAS linking mechanism does not require link information in the runtime response.</p>
@@ -2606,10 +2606,10 @@
 </code></pre>
 <p>Note that in the use of <code>operationRef</code>, the <em>escaped forward-slash</em> is necessary when
 using JSON references.</p>
-</section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4>
+<p><a id="runtimeExpression"></a></section><section><h4><span>Runtime Expressions</span></h4></p>
 <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call.
 This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p>
-<p>The runtime expression is defined by the following [ABNF] syntax</p>
+<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p>
 <pre class="highlight "><code>
       expression = ( &quot;$url&quot; | &quot;$method&quot; | &quot;$statusCode&quot; | &quot;$request.&quot; source | &quot;$response.&quot; source )
       source = ( header-reference | query-reference | path-reference | body-reference )  
@@ -2624,7 +2624,7 @@
 </code></pre>
 <p>The <code>name</code> identifier is case-sensitive, whereas <code>token</code> is not.</p>
 <p>The table below provides examples of runtime expressions and examples of their use in a value:</p>
-</section><section><h4><span id="runtimeExpressionExamples">Examples</span></h4>
+<p><a id="runtimeExpressionExamples"></a></section><section><h4><span>Examples</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2673,7 +2673,7 @@
 </table>
 <p>Runtime expressions preserve the type of the referenced value.
 Expressions can be embedded into string values by surrounding the expression with <code>{}</code> curly braces.</p>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <p>The Header Object follows the structure of the <a href="#parameterObject">Parameter Object</a> with the following changes:</p>
 <ol>
 <li><code>name</code> MUST NOT be specified, it is given in the corresponding <code>headers</code> map.</li>
@@ -2683,19 +2683,19 @@
 <section><h4>Header Object Example</h4>
 <p>A simple header of type <code>integer</code>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">schema:</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Adds metadata to a single tag that is used by the <a href="#operationObject">Operation Object</a>.
 It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.</p>
 <section><h4>Fixed Fields</h4>
@@ -2728,16 +2728,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Tag Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;pet&quot;</span>,
-	<span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pets operations&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet&quot;</span><span class="hljs-punctuation">,</span>
+	<span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pets operations&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other components in the specification, internally and externally.</p>
 <p>The Reference Object is defined by <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a> and follows the same structure, behavior and rules.</p>
 <p>For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.</p>
@@ -2761,32 +2761,32 @@
 <p>This object cannot be extended with additional properties and any properties added SHALL be ignored.</p>
 </section><section><h4>Reference Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Pet&#x27;</span>
 </code></pre>
 </section><section><h4>Relative Schema Document Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;Pet.json&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet.json&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">Pet.yaml</span>
 </code></pre>
 </section><section><h4>Relative Documents With Embedded Schema Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">definitions.yaml#/Pet</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types.
 These types can be objects, but also primitives and arrays.
 This object is an extended subset of the <a href="http://json-schema.org/">JSON Schema Specification Wright Draft 00</a>.</p>
@@ -2882,7 +2882,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-<section><h5><span id="schemaComposition">Composition and Inheritance (Polymorphism)</span></h5>
+<p><a id="schemaComposition"></a><section><h5><span>Composition and Inheritance (Polymorphism)</span></h5></p>
 <p>The OpenAPI Specification allows combining and extending model definitions using the <code>allOf</code> property of JSON Schema, in effect offering model composition.
 <code>allOf</code> takes an array of object definitions that are validated <em>independently</em> but together compose a single object.</p>
 <p>While composition offers model extensibility, it does not imply a hierarchy between the models.
@@ -2901,10 +2901,10 @@
 </section></section><section><h4>Schema Object Examples</h4>
 <section><h5>Primitive Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-  <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;email&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;email&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
@@ -2912,25 +2912,25 @@
 </code></pre>
 </section><section><h5>Simple Model</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;address&quot;</span>: {
-      <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
-    },
-    <span class="hljs-attr">&quot;age&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-      <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-    }
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;address&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;age&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2949,12 +2949,12 @@
 </section><section><h5>Model with Map/Dictionary Properties</h5>
 <p>For a simple string to string mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2963,12 +2963,12 @@
 </code></pre>
 <p>For a string to model mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2977,25 +2977,25 @@
 </code></pre>
 </section><section><h5>Model with Example</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;id&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    },
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;example&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-    <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">1</span>
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3013,47 +3013,47 @@
 </code></pre>
 </section><section><h5>Models with Composition</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;ErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;message&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;ErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;message&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;code&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;message&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;code&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-            <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">100</span>,
-            <span class="hljs-attr">&quot;maximum&quot;</span>: <span class="hljs-number">600</span>
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">100</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;maximum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">600</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;rootCause&quot;</span>
-            ],
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;rootCause&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;rootCause&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3082,80 +3082,80 @@
 </code></pre>
 </section><section><h5>Models with Polymorphism Support</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;Pet&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;discriminator&quot;</span>: {
-          <span class="hljs-attr">&quot;propertyName&quot;</span>: <span class="hljs-string">&quot;petType&quot;</span>
-        },
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;name&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;petType&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          }
-        },
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;name&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;Pet&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;discriminator&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;propertyName&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petType&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;name&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;petType&quot;</span>
-        ]
-      },
-      <span class="hljs-attr">&quot;Cat&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;huntingSkill&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The measured skill for hunting&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;lazy&quot;</span>,
-                <span class="hljs-attr">&quot;enum&quot;</span>: [
-                  <span class="hljs-string">&quot;clueless&quot;</span>,
-                  <span class="hljs-string">&quot;lazy&quot;</span>,
-                  <span class="hljs-string">&quot;adventurous&quot;</span>,
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Cat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;huntingSkill&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The measured skill for hunting&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+                  <span class="hljs-string">&quot;clueless&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;adventurous&quot;</span><span class="hljs-punctuation">,</span>
                   <span class="hljs-string">&quot;aggressive&quot;</span>
-                ]
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+                <span class="hljs-punctuation">]</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;huntingSkill&quot;</span>
-            ]
-          }
-        ]
-      },
-      <span class="hljs-attr">&quot;Dog&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;packSize&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-                <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-number">0</span>,
-                <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;packSize&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;packSize&quot;</span>
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3203,7 +3203,7 @@
         <span class="hljs-attr">required:</span>
         <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="discriminatorObject">Discriminator Object</span></h3>
+<p><a id="discriminatorObject"></a></section></section></section><section><h3><span>Discriminator Object</span></h3></p>
 <p>When request bodies or response payloads may be one of a number of different schemas, a <code>discriminator</code> object can be used to aid in serialization, deserialization, and validation.  The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.</p>
 <p>When using the discriminator, <em>inline</em> schemas will not be considered.</p>
 <section><h4>Fixed Fields</h4>
@@ -3327,7 +3327,7 @@
 }
 </code></pre>
 <p>will map to <code>Dog</code> because of the definition in the <code>mappings</code> element.</p>
-</section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property SHOULD be used to add that information.
 See examples for expected behavior.</p>
@@ -3374,11 +3374,11 @@
 <section><h5>No XML Element</h5>
 <p>Basic string property:</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3389,14 +3389,14 @@
 </code></pre>
 <p>Basic string array property (<a href="#xmlWrapped"><code>wrapped</code></a> is <code>false</code> by default):</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3411,14 +3411,14 @@
 </code></pre>
 </section><section><h5>XML Name Replacement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3432,27 +3432,27 @@
 </section><section><h5>XML Attribute, Prefix and Namespace</h5>
 <p>In this example, a full model definition is shown.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;Person&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;properties&quot;</span>: {
-      <span class="hljs-attr">&quot;id&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-        <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;attribute&quot;</span>: <span class="hljs-literal">true</span>
-        }
-      },
-      <span class="hljs-attr">&quot;name&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;namespace&quot;</span>: <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span>,
-          <span class="hljs-attr">&quot;prefix&quot;</span>: <span class="hljs-string">&quot;sample&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;Person&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;attribute&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;namespace&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;prefix&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;sample&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">Person:</span>
@@ -3477,17 +3477,17 @@
 </section><section><h5>XML Arrays</h5>
 <p>Changing the element names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3503,20 +3503,20 @@
 </code></pre>
 <p>The external <code>name</code> property has no effect on the XML:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3534,17 +3534,17 @@
 </code></pre>
 <p>Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3562,20 +3562,20 @@
 </code></pre>
 <p>To overcome the naming problem in the example above, the following definition can be used:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3595,21 +3595,21 @@
 </code></pre>
 <p>Affecting both internal and external names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3630,18 +3630,18 @@
 </code></pre>
 <p>If we change the external element but not the internal ones:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3658,7 +3658,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Defines a security scheme that can be used by the operations.
 Supported schemes are HTTP authentication, an API key (either as a header or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and <a href="https://tools.ietf.org/html/draft-ietf-oauth-discovery-06">OpenID Connect Discovery</a>.</p>
 <section><h4>Fixed Fields</h4>
@@ -3726,10 +3726,10 @@
 </section><section><h4>Security Scheme Object Example</h4>
 <section><h5>Basic Authentication Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;basic&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;basic&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3737,11 +3737,11 @@
 </code></pre>
 </section><section><h5>API Key Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;apiKey&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;api_key&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">apiKey</span>
@@ -3750,11 +3750,11 @@
 </code></pre>
 </section><section><h5>JWT Bearer Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;bearer&quot;</span>,
-  <span class="hljs-attr">&quot;bearerFormat&quot;</span>: <span class="hljs-string">&quot;JWT&quot;</span>,
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;bearer&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bearerFormat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;JWT&quot;</span><span class="hljs-punctuation">,</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3763,18 +3763,18 @@
 </code></pre>
 </section><section><h5>Implicit OAuth2 Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3785,7 +3785,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="oauthFlowsObject">OAuth Flows Object</span></h3>
+<p><a id="oauthFlowsObject"></a></section></section></section><section><h3><span>OAuth Flows Object</span></h3></p>
 <p>Allows configuration of the supported OAuth Flows.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3820,7 +3820,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="oauthFlowObject">OAuth Flow Object</span></h3>
+<p><a id="oauthFlowObject"></a></section></section><section><h3><span>OAuth Flow Object</span></h3></p>
 <p>Configuration details for a supported OAuth Flow</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3862,26 +3862,26 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>OAuth Flow Object Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;authorizationCode&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;tokenUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;authorizationCode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;tokenUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3898,7 +3898,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span> 
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation.
 The name used for each property MUST correspond to a security scheme declared in the <a href="#componentsSecuritySchemes">Security Schemes</a> under the <a href="#componentsObject">Components Object</a>.</p>
 <p>Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
@@ -3924,28 +3924,28 @@
 </section><section><h4>Security Requirement Object Examples</h4>
 <section><h5>Non-OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;api_key&quot;</span>: []
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">api_key:</span> []
 </code></pre>
 </section><section><h5>OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-    <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
     <span class="hljs-string">&quot;read:pets&quot;</span>
-  ]
-}
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">petstore_auth:</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="specificationExtensions">Specification Extensions</span></h2>
+<p><a id="specificationExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are implemented as patterned fields that are always prefixed by <code>&quot;x-&quot;</code>.</p>
 <table>
@@ -3965,7 +3965,7 @@
 </tbody>
 </table>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning is to allow an additional layer of access control over the documentation.
 While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
@@ -3974,7 +3974,7 @@
 <li>The <a href="#pathsObject">Paths Object</a> MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the <a href="#infoObject">Info Object</a> which may contain additional information regarding authentication.</li>
 <li>The <a href="#pathItemObject">Path Item Object</a> MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the <a href="#pathsObject">Paths Object</a>, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.</li>
 </ol>
-</section></section><section><h1><span id="revisionHistory">Appendix A: Revision History</span></h1>
+<p><a id="revisionHistory"></a></section></section><section><h1><span>Appendix A: Revision History</span></h1></p>
 <table>
 <thead>
 <tr>
diff --git a/oas/v3.0.2.html b/oas/v3.0.2.html
index 7156024e05..284d257a54 100644
--- a/oas/v3.0.2.html
+++ b/oas/v3.0.2.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.2 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "},{"name":"Uri Sarid "}],"formerEditors":[{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2018-10-08T00:00:00.000Z","subtitle":"Version 3.0.2","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.2 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "}],"formerEditors":[{"name":"Uri Sarid "},{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2018-10-08T00:00:00.000Z","subtitle":"Version 3.0.2","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-831873-42"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
@@ -16,11 +16,11 @@
 <p>An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.</p>
 <!-- /TOC -->
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="oasDocument"><dfn>OpenAPI Document</dfn></span></h4>
+<p><a id="oasDocument"></a><section><h4><span><dfn>OpenAPI Document</dfn></span></h4></p>
 <p>A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.</p>
-</section><section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a></section><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of curly braces ({}) to mark a section of a URL path as replaceable using path parameters.</p>
-</section><section><h4><span id="mediaTypes"><dfn>Media Types</dfn></span></h4>
+<p><a id="mediaTypes"></a></section><section><h4><span><dfn>Media Types</dfn></span></h4></p>
 <p>Media type definitions are spread across several resources.
 The media type definitions SHOULD be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible media type definitions:</p>
@@ -36,7 +36,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation.
 The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the <a href="https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
@@ -49,9 +49,9 @@
 <p>An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.</p>
 <p>For example, if a field has an array value, the JSON array representation will be used:</p>
 <pre class="nohighlight"><code>
-{
-   <span class="hljs-attr">&quot;field&quot;</span>: [ <span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span> ]
-}
+<span class="hljs-punctuation">{</span>
+   <span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span> <span class="hljs-number">1</span><span class="hljs-punctuation">,</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span> <span class="hljs-number">3</span> <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>All field names in the specification are <strong>case sensitive</strong>.
 This includes all fields that are used as keys in a map, except where explicitly noted that keys are <strong>case insensitive</strong>.</p>
@@ -63,10 +63,10 @@
 <li>Keys used in YAML maps MUST be limited to a scalar string, as defined by the <a href="http://yaml.org/spec/1.2/spec.html#id2802346">YAML Failsafe schema ruleset</a>.</li>
 </ul>
 <p><strong>Note:</strong> While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.</p>
-</section><section><h2><span id="documentStructure">Document Structure</span></h2>
+<p><a id="documentStructure"></a></section><section><h2><span>Document Structure</span></h2></p>
 <p>An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, <code>$ref</code> fields MUST be used in the specification to reference those parts as follows from the <a href="http://json-schema.org">JSON Schema</a> definitions.</p>
 <p>It is RECOMMENDED that the root OpenAPI document be named: <code>openapi.json</code> or <code>openapi.yaml</code>.</p>
-</section><section><h2><span id="dataTypes">Data Types</span></h2>
+<p><a id="dataTypes"></a></section><section><h2><span>Data Types</span></h2></p>
 <p>Primitive data types in the OAS are based on the types supported by the <a href="https://tools.ietf.org/html/draft-wright-json-schema-00#section-4.2">JSON Schema Specification Wright Draft 00</a>.
 Note that <code>integer</code> as a type is also supported and is defined as a JSON number without a fraction or exponent part.
 <code>null</code> is not supported as a type (see <a href="#schemaNullable"><code>nullable</code></a> for an alternative solution).
@@ -129,12 +129,12 @@
 <tr>
 <td><code>string</code></td>
 <td><code>date</code></td>
-<td>As defined by <code>full-date</code> - [[!RFC3339]]</td>
+<td>As defined by <code>full-date</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td><code>string</code></td>
 <td><code>date-time</code></td>
-<td>As defined by <code>date-time</code> - [[!RFC3339]]</td>
+<td>As defined by <code>date-time</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td><code>string</code></td>
@@ -143,16 +143,16 @@
 </tr>
 </tbody>
 </table>
-</section><section><h2><span id="richText">Rich Text Formatting</span></h2>
+<p><a id="richText"></a></section><section><h2><span>Rich Text Formatting</span></h2></p>
 <p>Throughout the specification <code>description</code> fields are noted as supporting CommonMark markdown formatting.
 Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by <a href="http://spec.commonmark.org/0.27/">CommonMark 0.27</a>. Tooling MAY choose to ignore some CommonMark features to address security concerns.</p>
-</section><section><h2><span id="relativeReferences">Relative References in URLs</span></h2>
+<p><a id="relativeReferences"></a></section><section><h2><span>Relative References in URLs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]].
 Relative references are resolved using the URLs defined in the <a href="#serverObject"><code>Server Object</code></a> as a Base URI.</p>
 <p>Relative references used in <code>$ref</code> are processed as per <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a>, using the URL of the current document as the base URI. See also the <a href="#referenceObject">Reference Object</a>.</p>
 </section><section><h2>Schema</h2>
 <p>In the following description, if a field is not explicitly <strong>REQUIRED</strong> or described with a MUST or SHALL, it can be considered OPTIONAL.</p>
-<section><h3><span id="oasObject">OpenAPI Object</span></h3>
+<p><a id="oasObject"></a><section><h3><span>OpenAPI Object</span></h3></p>
 <p>This is the root document object of the <a href="#oasDocument">OpenAPI document</a>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -207,7 +207,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API.
 The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.</p>
 <section><h4>Fixed Fields</h4>
@@ -255,21 +255,21 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Info Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;Sample Pet Store App&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span>,
-  <span class="hljs-attr">&quot;termsOfService&quot;</span>: <span class="hljs-string">&quot;http://example.com/terms/&quot;</span>,
-  <span class="hljs-attr">&quot;contact&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-    <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-  },
-  <span class="hljs-attr">&quot;license&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-  },
-  <span class="hljs-attr">&quot;version&quot;</span>: <span class="hljs-string">&quot;1.0.1&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;title&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Sample Pet Store App&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;termsOfService&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/terms/&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;contact&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;license&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;version&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;1.0.1&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">title:</span> <span class="hljs-string">Sample</span> <span class="hljs-string">Pet</span> <span class="hljs-string">Store</span> <span class="hljs-string">App</span>
@@ -284,7 +284,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -316,18 +316,18 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Contact Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-  <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">API</span> <span class="hljs-string">Support</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.example.com/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@example.com</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -354,16 +354,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>License Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 </code></pre>
-</section></section><section><h3><span id="serverObject">Server Object</span></h3>
+<p><a id="serverObject"></a></section></section><section><h3><span>Server Object</span></h3></p>
 <p>An object representing a Server.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -396,10 +396,10 @@
 </section><section><h4>Server Object Example</h4>
 <p>A single server would be described as:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://development.gigantic-server.com/v1</span>
@@ -407,22 +407,22 @@
 </code></pre>
 <p>The following shows how multiple servers can be described, for example, at the OpenAPI Object’s <a href="#oasServers"><code>servers</code></a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Staging server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Production server&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Staging server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Production server&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -435,30 +435,30 @@
 </code></pre>
 <p>The following shows how variables can be used for a server configuration:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The production API server&quot;</span>,
-      <span class="hljs-attr">&quot;variables&quot;</span>: {
-        <span class="hljs-attr">&quot;username&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;demo&quot;</span>,
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
-        },
-        <span class="hljs-attr">&quot;port&quot;</span>: {
-          <span class="hljs-attr">&quot;enum&quot;</span>: [
-            <span class="hljs-string">&quot;8443&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The production API server&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;variables&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;username&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;demo&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;port&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+            <span class="hljs-string">&quot;8443&quot;</span><span class="hljs-punctuation">,</span>
             <span class="hljs-string">&quot;443&quot;</span>
-          ],
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;8443&quot;</span>
-        },
-        <span class="hljs-attr">&quot;basePath&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;v2&quot;</span>
-        }
-      }
-    }
-  ]
-}
+          <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;8443&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;basePath&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;v2&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -478,7 +478,7 @@
       <span class="hljs-comment"># open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`</span>
       <span class="hljs-attr">default:</span> <span class="hljs-string">v2</span>
 </code></pre>
-</section></section><section><h3><span id="serverVariableObject">Server Variable Object</span></h3>
+<p><a id="serverVariableObject"></a></section></section><section><h3><span>Server Variable Object</span></h3></p>
 <p>An object representing a Server Variable for server URL template substitution.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -508,7 +508,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="componentsObject">Components Object</span></h3>
+<p><a id="componentsObject"></a></section></section><section><h3><span>Components Object</span></h3></p>
 <p>Holds a set of reusable objects for different aspects of the OAS.
 All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.</p>
 <section><h4>Fixed Fields</h4>
@@ -580,105 +580,105 @@
 </code></pre>
 </section><section><h4>Components Object Example</h4>
 <pre class="nohighlight"><code>
-&quot;components&quot;: {
-  &quot;schemas&quot;: {
-    &quot;GeneralError&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;code&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int32&quot;
-        },
-        &quot;message&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Category&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Tag&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    }
-  },
-  &quot;parameters&quot;: {
-    &quot;skipParam&quot;: {
-      &quot;name&quot;: &quot;skip&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;number of items to skip&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot;: {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    },
-    &quot;limitParam&quot;: {
-      &quot;name&quot;: &quot;limit&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;max records to return&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot; : {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    }
-  },
-  &quot;responses&quot;: {
-    &quot;NotFound&quot;: {
-      &quot;description&quot;: &quot;Entity not found.&quot;
-    },
-    &quot;IllegalInput&quot;: {
-      &quot;description&quot;: &quot;Illegal input for operation.&quot;
-    },
-    &quot;GeneralError&quot;: {
-      &quot;description&quot;: &quot;General Error&quot;,
-      &quot;content&quot;: {
-        &quot;application/json&quot;: {
-          &quot;schema&quot;: {
-            &quot;$ref&quot;: &quot;#/components/schemas/GeneralError&quot;
-          }
-        }
-      }
-    }
-  },
-  &quot;securitySchemes&quot;: {
-    &quot;api_key&quot;: {
-      &quot;type&quot;: &quot;apiKey&quot;,
-      &quot;name&quot;: &quot;api_key&quot;,
-      &quot;in&quot;: &quot;header&quot;
-    },
-    &quot;petstore_auth&quot;: {
-      &quot;type&quot;: &quot;oauth2&quot;,
-      &quot;flows&quot;: {
-        &quot;implicit&quot;: {
-          &quot;authorizationUrl&quot;: &quot;http://example.org/api/oauth/dialog&quot;,
-          &quot;scopes&quot;: {
-            &quot;write:pets&quot;: &quot;modify pets in your account&quot;,
-            &quot;read:pets&quot;: &quot;read your pets&quot;
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Category&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Tag&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;skipParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number of items to skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;limitParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;limit&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;max records to return&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;NotFound&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Entity not found.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;IllegalInput&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Illegal input for operation.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;General Error&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/GeneralError&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;securitySchemes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.org/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -749,7 +749,7 @@
             <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
             <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints and their operations.
 The path is appended to the URL from the <a href="#serverObject"><code>Server Object</code></a> in order to construct the full URL.  The Paths MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -788,28 +788,28 @@
 </code></pre>
 </section><section><h4>Paths Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;/pets&quot;</span>: {
-    <span class="hljs-attr">&quot;get&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span>,
-      <span class="hljs-attr">&quot;responses&quot;</span>: {
-        <span class="hljs-attr">&quot;200&quot;</span>: {          
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A list of pets.&quot;</span>,
-          <span class="hljs-attr">&quot;content&quot;</span>: {
-            <span class="hljs-attr">&quot;application/json&quot;</span>: {
-              <span class="hljs-attr">&quot;schema&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-                <span class="hljs-attr">&quot;items&quot;</span>: {
-                  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;/pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>          
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A list of pets.&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
+                <span class="hljs-punctuation">}</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">/pets:</span>
@@ -825,7 +825,7 @@
               <span class="hljs-attr">items:</span>
                 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.
 The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
@@ -909,53 +909,53 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Path Item Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;get&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns pets based on ID&quot;</span>,
-    <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Find pets by ID&quot;</span>,
-    <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;getPetsById&quot;</span>,
-    <span class="hljs-attr">&quot;responses&quot;</span>: {
-      <span class="hljs-attr">&quot;200&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;pet response&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;*/*&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-              <span class="hljs-attr">&quot;items&quot;</span>: {
-                <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-              }
-            }
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;default&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;error payload&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;text/html&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-            }
-          }
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet to use&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      },
-      <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns pets based on ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find pets by ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;getPetsById&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet response&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;error payload&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;text/html&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet to use&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">get:</span>
@@ -988,7 +988,7 @@
     <span class="hljs-attr">items:</span>
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>  
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1065,68 +1065,68 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Operation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;tags&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;tags&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;pet&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span>,
-  <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;updatePetWithForm&quot;</span>,
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;petId&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  ],
-  <span class="hljs-attr">&quot;requestBody&quot;</span>: {
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-           <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;name&quot;</span>: { 
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated name of the pet&quot;</span>,
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              },
-              <span class="hljs-attr">&quot;status&quot;</span>: {
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated status of the pet&quot;</span>,
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-             }
-           },
-        <span class="hljs-attr">&quot;required&quot;</span>: [<span class="hljs-string">&quot;status&quot;</span>] 
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;responses&quot;</span>: {
-    <span class="hljs-attr">&quot;200&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pet updated.&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    },
-    <span class="hljs-attr">&quot;405&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Method Not Allowed&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;updatePetWithForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petId&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;requestBody&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+           <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span> 
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated name of the pet&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;status&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated status of the pet&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+             <span class="hljs-punctuation">}</span>
+           <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-string">&quot;status&quot;</span><span class="hljs-punctuation">]</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet updated.&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;405&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Method Not Allowed&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">tags:</span>
@@ -1169,7 +1169,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1196,16 +1196,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>External Documentation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Find more info here&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find more info here&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://example.com</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <section><h4>Parameter Locations</h4>
@@ -1490,20 +1490,20 @@
 </section><section><h4>Parameter Object Examples</h4>
 <p>A header parameter with an array of 64 bit integer numbers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;token&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;token to be passed as a header&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token to be passed as a header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">token</span>
@@ -1519,15 +1519,15 @@
 </code></pre>
 <p>A path parameter of a string value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;username&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;username to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">username</span>
@@ -1539,20 +1539,20 @@
 </code></pre>
 <p>An optional query parameter of a string value, allowing multiple values by repeating the query parameter:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of the object to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">false</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>,
-  <span class="hljs-attr">&quot;explode&quot;</span>: <span class="hljs-literal">true</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of the object to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;explode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">id</span>
@@ -1568,17 +1568,17 @@
 </code></pre>
 <p>A free-form query parameter, allowing undefined parameters of a specific type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;freeForm&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-    },
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;freeForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1591,29 +1591,29 @@
 </code></pre>
 <p>A complex parameter using <code>content</code> to define serialization:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;coordinates&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;lat&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;coordinates&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;lat&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;long&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;lat&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          },
-          <span class="hljs-attr">&quot;long&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          }
-        }
-      }
-    }
-  }
-}
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;lat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;long&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1631,7 +1631,7 @@
         <span class="hljs-attr">long:</span>
           <span class="hljs-attr">type:</span> <span class="hljs-string">number</span>
 </code></pre>
-</section></section><section><h3><span id="requestBodyObject">Request Body Object</span></h3>
+<p><a id="requestBodyObject"></a></section></section><section><h3><span>Request Body Object</span></h3></p>
 <p>Describes a single request body.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1651,7 +1651,7 @@
 <tr>
 <td><a id="requestBodyContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="requestBodyRequired"> </a>required</td>
@@ -1664,49 +1664,49 @@
 </section><section><h4>Request Body Examples</h4>
 <p>A request body with a referenced model definition.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User Example&quot;</span>, 
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
-          } 
-        }
-    },
-    <span class="hljs-attr">&quot;application/xml&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in XML&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
-          }
-        }
-    },
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in Plain text&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
-        }
-      } 
-    },
-    <span class="hljs-attr">&quot;*/*&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in other format&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User Example&quot;</span><span class="hljs-punctuation">,</span> 
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
+          <span class="hljs-punctuation">}</span> 
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in XML&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in Plain text&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span> 
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in other format&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1738,19 +1738,19 @@
 </code></pre>
 <p>A body parameter that is an array of string values:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1762,7 +1762,7 @@
       <span class="hljs-attr">items:</span>
         <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="mediaTypeObject">Media Type Object</span></h3>
+<p><a id="mediaTypeObject"></a></section></section><section><h3><span>Media Type Object</span></h3></p>
 <p>Each Media Type Object provides schema and examples for the media type identified by its key.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1799,39 +1799,39 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Media Type Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;application/json&quot;</span>: {
-    <span class="hljs-attr">&quot;schema&quot;</span>: {
-         <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-    },
-    <span class="hljs-attr">&quot;examples&quot;</span>: {
-      <span class="hljs-attr">&quot;cat&quot;</span> : {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a cat&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span>: 
-          {
-            <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Fluffy&quot;</span>,
-            <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-            <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;White&quot;</span>,
-            <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;male&quot;</span>,
-            <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Persian&quot;</span>
-          }
-      },
-      <span class="hljs-attr">&quot;dog&quot;</span>: {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span> :  { 
-          <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-          <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Dog&quot;</span>,
-          <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;Black&quot;</span>,
-          <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;Female&quot;</span>,
-          <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Mixed&quot;</span>
-        },
-      <span class="hljs-attr">&quot;frog&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+         <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;cat&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a cat&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span><span class="hljs-punctuation">:</span> 
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Fluffy&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;White&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;male&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Persian&quot;</span>
+          <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span> <span class="hljs-punctuation">:</span>  <span class="hljs-punctuation">{</span> 
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Dog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Black&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Female&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Mixed&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;frog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">application/json:</span> 
@@ -1972,7 +1972,7 @@
               <span class="hljs-attr">type:</span> <span class="hljs-string">&#x27;#/components/schemas/Address&#x27;</span>
 </code></pre>
 <p>An <code>encoding</code> attribute is introduced to give you control over the serialization of parts of <code>multipart</code> request bodies.  This attribute is <em>only</em> applicable to <code>multipart</code> and <code>application/x-www-form-urlencoded</code> request bodies.</p>
-</section></section><section><h3><span id="encodingObject">Encoding Object</span></h3>
+<p><a id="encodingObject"></a></section></section><section><h3><span>Encoding Object</span></h3></p>
 <p>A single encoding definition applied to a single schema property.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2050,7 +2050,7 @@
               <span class="hljs-attr">schema:</span>
                 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.</p>
 <p>The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
@@ -2097,28 +2097,28 @@
 </section><section><h4>Responses Object Example</h4>
 <p>A 200 response for a successful operation and a default response for others (implying an error):</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;200&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;a pet to be returned&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;default&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Unexpected error&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;a pet to be returned&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Unexpected error&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">&#x27;200&#x27;:</span>
@@ -2134,7 +2134,7 @@
       <span class="hljs-attr">schema:</span>
         <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation, including design-time, static
 <code>links</code> to operations based on the response.</p>
 <section><h4>Fixed Fields</h4>
@@ -2160,7 +2160,7 @@
 <tr>
 <td><a id="responseContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="responseLinks"> </a>links</td>
@@ -2173,19 +2173,19 @@
 </section><section><h4>Response Object Examples</h4>
 <p>Response of an array of a complex type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A complex object array response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A complex object array response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">complex</span> <span class="hljs-string">object</span> <span class="hljs-string">array</span> <span class="hljs-string">response</span>
@@ -2198,17 +2198,17 @@
 </code></pre>
 <p>Response with a string type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  }
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
 
-}
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2219,36 +2219,36 @@
 </code></pre>
 <p>Plain text response with headers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;headers&quot;</span>: {
-    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;headers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2273,14 +2273,14 @@
 </code></pre>
 <p>Response with no return value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;object created&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object created&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="callbackObject">Callback Object</span></h3>
+<p><a id="callbackObject"></a></section></section><section><h3><span>Callback Object</span></h3></p>
 <p>A map of possible out-of band callbacks related to the parent operation.
 Each value in the map is a <a href="#pathItemObject">Path Item Object</a> that describes a set of requests that may be initiated by the API provider and the expected responses.
 The key value used to identify the callback object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.</p>
@@ -2314,7 +2314,7 @@
 <span class="hljs-attribute">Content-Type</span><span class="hljs-punctuation">: </span>application/json
 <span class="hljs-attribute">Content-Length</span><span class="hljs-punctuation">: </span>187
 
-<span class="awk">{
+<span class="language-avrasm">{
   <span class="hljs-string">&quot;failedUrl&quot;</span> : <span class="hljs-string">&quot;http://clientdomain.com/failed&quot;</span>,
   <span class="hljs-string">&quot;successUrls&quot;</span> : [
     <span class="hljs-string">&quot;http://clientdomain.com/fast&quot;</span>,
@@ -2324,7 +2324,7 @@
 }
 
 <span class="hljs-number">201</span> Created
-Location: http:<span class="hljs-regexp">//</span>example.org<span class="hljs-regexp">/subscription/</span><span class="hljs-number">1</span>
+<span class="hljs-symbol">Location:</span> http://example<span class="hljs-meta">.org</span>/subscription/<span class="hljs-number">1</span>
 </span></code></pre>
 <p>The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named <code>eventType</code> and a query parameter named <code>queryUrl</code>.</p>
 <table>
@@ -2385,7 +2385,7 @@
         <span class="hljs-attr">&#x27;200&#x27;:</span>
           <span class="hljs-attr">description:</span> <span class="hljs-string">webhook</span> <span class="hljs-string">successfully</span> <span class="hljs-string">processed</span> <span class="hljs-string">and</span> <span class="hljs-literal">no</span> <span class="hljs-string">retries</span> <span class="hljs-string">will</span> <span class="hljs-string">be</span> <span class="hljs-string">performed</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <section><h4>Fixed Fields</h4>
 <table>
 <thead>
@@ -2483,7 +2483,7 @@
           <span class="hljs-attr">confirmation-success:</span>
             <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/examples/confirmation-success&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="linkObject">Link Object</span></h3>
+<p><a id="linkObject"></a></section></section><section><h3><span>Link Object</span></h3></p>
 <p>The <code>Link object</code> represents a possible design-time link for a response.
 The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.</p>
 <p>Unlike <em>dynamic</em> links (i.e. links provided <strong>in</strong> the response payload), the OAS linking mechanism does not require link information in the runtime response.</p>
@@ -2617,10 +2617,10 @@
 </code></pre>
 <p>Note that in the use of <code>operationRef</code>, the <em>escaped forward-slash</em> is necessary when
 using JSON references.</p>
-</section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4>
+<p><a id="runtimeExpression"></a></section><section><h4><span>Runtime Expressions</span></h4></p>
 <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call.
 This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p>
-<p>The runtime expression is defined by the following [ABNF] syntax</p>
+<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p>
 <pre class="highlight "><code>
       expression = ( &quot;$url&quot; | &quot;$method&quot; | &quot;$statusCode&quot; | &quot;$request.&quot; source | &quot;$response.&quot; source )
       source = ( header-reference | query-reference | path-reference | body-reference )  
@@ -2635,7 +2635,7 @@
 </code></pre>
 <p>The <code>name</code> identifier is case-sensitive, whereas <code>token</code> is not.</p>
 <p>The table below provides examples of runtime expressions and examples of their use in a value:</p>
-</section><section><h4><span id="runtimeExpressionExamples">Examples</span></h4>
+<p><a id="runtimeExpressionExamples"></a></section><section><h4><span>Examples</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2684,7 +2684,7 @@
 </table>
 <p>Runtime expressions preserve the type of the referenced value.
 Expressions can be embedded into string values by surrounding the expression with <code>{}</code> curly braces.</p>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <p>The Header Object follows the structure of the <a href="#parameterObject">Parameter Object</a> with the following changes:</p>
 <ol>
 <li><code>name</code> MUST NOT be specified, it is given in the corresponding <code>headers</code> map.</li>
@@ -2694,19 +2694,19 @@
 <section><h4>Header Object Example</h4>
 <p>A simple header of type <code>integer</code>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">schema:</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Adds metadata to a single tag that is used by the <a href="#operationObject">Operation Object</a>.
 It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.</p>
 <section><h4>Fixed Fields</h4>
@@ -2739,16 +2739,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Tag Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;pet&quot;</span>,
-	<span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pets operations&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet&quot;</span><span class="hljs-punctuation">,</span>
+	<span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pets operations&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other components in the specification, internally and externally.</p>
 <p>The Reference Object is defined by <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a> and follows the same structure, behavior and rules.</p>
 <p>For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.</p>
@@ -2772,32 +2772,32 @@
 <p>This object cannot be extended with additional properties and any properties added SHALL be ignored.</p>
 </section><section><h4>Reference Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Pet&#x27;</span>
 </code></pre>
 </section><section><h4>Relative Schema Document Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;Pet.json&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet.json&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">Pet.yaml</span>
 </code></pre>
 </section><section><h4>Relative Documents With Embedded Schema Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">definitions.yaml#/Pet</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types.
 These types can be objects, but also primitives and arrays.
 This object is an extended subset of the <a href="http://json-schema.org/">JSON Schema Specification Wright Draft 00</a>.</p>
@@ -2893,7 +2893,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-<section><h5><span id="schemaComposition">Composition and Inheritance (Polymorphism)</span></h5>
+<p><a id="schemaComposition"></a><section><h5><span>Composition and Inheritance (Polymorphism)</span></h5></p>
 <p>The OpenAPI Specification allows combining and extending model definitions using the <code>allOf</code> property of JSON Schema, in effect offering model composition.
 <code>allOf</code> takes an array of object definitions that are validated <em>independently</em> but together compose a single object.</p>
 <p>While composition offers model extensibility, it does not imply a hierarchy between the models.
@@ -2912,10 +2912,10 @@
 </section></section><section><h4>Schema Object Examples</h4>
 <section><h5>Primitive Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-  <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;email&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;email&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
@@ -2923,25 +2923,25 @@
 </code></pre>
 </section><section><h5>Simple Model</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;address&quot;</span>: {
-      <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
-    },
-    <span class="hljs-attr">&quot;age&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-      <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-    }
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;address&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;age&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2960,12 +2960,12 @@
 </section><section><h5>Model with Map/Dictionary Properties</h5>
 <p>For a simple string to string mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2974,12 +2974,12 @@
 </code></pre>
 <p>For a string to model mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2988,25 +2988,25 @@
 </code></pre>
 </section><section><h5>Model with Example</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;id&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    },
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;example&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-    <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">1</span>
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3024,47 +3024,47 @@
 </code></pre>
 </section><section><h5>Models with Composition</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;ErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;message&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;ErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;message&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;code&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;message&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;code&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-            <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">100</span>,
-            <span class="hljs-attr">&quot;maximum&quot;</span>: <span class="hljs-number">600</span>
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">100</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;maximum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">600</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;rootCause&quot;</span>
-            ],
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;rootCause&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;rootCause&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3093,80 +3093,80 @@
 </code></pre>
 </section><section><h5>Models with Polymorphism Support</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;Pet&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;discriminator&quot;</span>: {
-          <span class="hljs-attr">&quot;propertyName&quot;</span>: <span class="hljs-string">&quot;petType&quot;</span>
-        },
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;name&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;petType&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          }
-        },
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;name&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;Pet&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;discriminator&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;propertyName&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petType&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;name&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;petType&quot;</span>
-        ]
-      },
-      <span class="hljs-attr">&quot;Cat&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;huntingSkill&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The measured skill for hunting&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;lazy&quot;</span>,
-                <span class="hljs-attr">&quot;enum&quot;</span>: [
-                  <span class="hljs-string">&quot;clueless&quot;</span>,
-                  <span class="hljs-string">&quot;lazy&quot;</span>,
-                  <span class="hljs-string">&quot;adventurous&quot;</span>,
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Cat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;huntingSkill&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The measured skill for hunting&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+                  <span class="hljs-string">&quot;clueless&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;adventurous&quot;</span><span class="hljs-punctuation">,</span>
                   <span class="hljs-string">&quot;aggressive&quot;</span>
-                ]
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+                <span class="hljs-punctuation">]</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;huntingSkill&quot;</span>
-            ]
-          }
-        ]
-      },
-      <span class="hljs-attr">&quot;Dog&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;packSize&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-                <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-number">0</span>,
-                <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;packSize&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;packSize&quot;</span>
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3214,7 +3214,7 @@
         <span class="hljs-attr">required:</span>
         <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="discriminatorObject">Discriminator Object</span></h3>
+<p><a id="discriminatorObject"></a></section></section></section><section><h3><span>Discriminator Object</span></h3></p>
 <p>When request bodies or response payloads may be one of a number of different schemas, a <code>discriminator</code> object can be used to aid in serialization, deserialization, and validation.  The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.</p>
 <p>When using the discriminator, <em>inline</em> schemas will not be considered.</p>
 <section><h4>Fixed Fields</h4>
@@ -3260,10 +3260,10 @@
 </code></pre>
 <p>The expectation now is that a property with name <code>petType</code> <em>MUST</em> be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document.  Thus the response payload:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">12345</span>,
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">12345</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>Will indicate that the <code>Cat</code> schema be used in conjunction with this payload.</p>
 <p>In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional <code>mapping</code> definition MAY be used:</p>
@@ -3325,20 +3325,20 @@
 </code></pre>
 <p>a payload like this:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;misty&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;misty&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will indicate that the <code>Cat</code> schema be used.  Likewise this schema:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;dog&quot;</span>,
-  <span class="hljs-attr">&quot;bark&quot;</span>: <span class="hljs-string">&quot;soft&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;dog&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bark&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;soft&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will map to <code>Dog</code> because of the definition in the <code>mappings</code> element.</p>
-</section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property SHOULD be used to add that information.
 See examples for expected behavior.</p>
@@ -3385,11 +3385,11 @@
 <section><h5>No XML Element</h5>
 <p>Basic string property:</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3400,14 +3400,14 @@
 </code></pre>
 <p>Basic string array property (<a href="#xmlWrapped"><code>wrapped</code></a> is <code>false</code> by default):</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3422,14 +3422,14 @@
 </code></pre>
 </section><section><h5>XML Name Replacement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3443,27 +3443,27 @@
 </section><section><h5>XML Attribute, Prefix and Namespace</h5>
 <p>In this example, a full model definition is shown.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;Person&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;properties&quot;</span>: {
-      <span class="hljs-attr">&quot;id&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-        <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;attribute&quot;</span>: <span class="hljs-literal">true</span>
-        }
-      },
-      <span class="hljs-attr">&quot;name&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;namespace&quot;</span>: <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span>,
-          <span class="hljs-attr">&quot;prefix&quot;</span>: <span class="hljs-string">&quot;sample&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;Person&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;attribute&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;namespace&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;prefix&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;sample&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">Person:</span>
@@ -3488,17 +3488,17 @@
 </section><section><h5>XML Arrays</h5>
 <p>Changing the element names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3514,20 +3514,20 @@
 </code></pre>
 <p>The external <code>name</code> property has no effect on the XML:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3545,17 +3545,17 @@
 </code></pre>
 <p>Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3573,20 +3573,20 @@
 </code></pre>
 <p>To overcome the naming problem in the example above, the following definition can be used:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3606,21 +3606,21 @@
 </code></pre>
 <p>Affecting both internal and external names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3641,18 +3641,18 @@
 </code></pre>
 <p>If we change the external element but not the internal ones:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3669,7 +3669,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Defines a security scheme that can be used by the operations.
 Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, application and access code) as defined in [[!RFC6749]], and <a href="https://tools.ietf.org/html/draft-ietf-oauth-discovery-06">OpenID Connect Discovery</a>.</p>
 <section><h4>Fixed Fields</h4>
@@ -3737,10 +3737,10 @@
 </section><section><h4>Security Scheme Object Example</h4>
 <section><h5>Basic Authentication Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;basic&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;basic&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3748,11 +3748,11 @@
 </code></pre>
 </section><section><h5>API Key Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;apiKey&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;api_key&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">apiKey</span>
@@ -3761,11 +3761,11 @@
 </code></pre>
 </section><section><h5>JWT Bearer Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;bearer&quot;</span>,
-  <span class="hljs-attr">&quot;bearerFormat&quot;</span>: <span class="hljs-string">&quot;JWT&quot;</span>,
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;bearer&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bearerFormat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;JWT&quot;</span><span class="hljs-punctuation">,</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3774,18 +3774,18 @@
 </code></pre>
 </section><section><h5>Implicit OAuth2 Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3796,7 +3796,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="oauthFlowsObject">OAuth Flows Object</span></h3>
+<p><a id="oauthFlowsObject"></a></section></section></section><section><h3><span>OAuth Flows Object</span></h3></p>
 <p>Allows configuration of the supported OAuth Flows.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3831,7 +3831,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="oauthFlowObject">OAuth Flow Object</span></h3>
+<p><a id="oauthFlowObject"></a></section></section><section><h3><span>OAuth Flow Object</span></h3></p>
 <p>Configuration details for a supported OAuth Flow</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3873,26 +3873,26 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>OAuth Flow Object Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;authorizationCode&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;tokenUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;authorizationCode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;tokenUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3909,7 +3909,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span> 
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation.
 The name used for each property MUST correspond to a security scheme declared in the <a href="#componentsSecuritySchemes">Security Schemes</a> under the <a href="#componentsObject">Components Object</a>.</p>
 <p>Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
@@ -3935,28 +3935,28 @@
 </section><section><h4>Security Requirement Object Examples</h4>
 <section><h5>Non-OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;api_key&quot;</span>: []
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">api_key:</span> []
 </code></pre>
 </section><section><h5>OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-    <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
     <span class="hljs-string">&quot;read:pets&quot;</span>
-  ]
-}
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">petstore_auth:</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
 <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="specificationExtensions">Specification Extensions</span></h2>
+<p><a id="specificationExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are implemented as patterned fields that are always prefixed by <code>&quot;x-&quot;</code>.</p>
 <table>
@@ -3976,7 +3976,7 @@
 </tbody>
 </table>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning is to allow an additional layer of access control over the documentation.
 While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
@@ -3985,7 +3985,7 @@
 <li>The <a href="#pathsObject">Paths Object</a> MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the <a href="#infoObject">Info Object</a> which may contain additional information regarding authentication.</li>
 <li>The <a href="#pathItemObject">Path Item Object</a> MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different than hiding the path itself from the <a href="#pathsObject">Paths Object</a>, so the user will not be aware of its existence. This allows the documentation provider to finely control what the viewer can see.</li>
 </ol>
-</section></section><section><h1><span id="revisionHistory">Appendix A: Revision History</span></h1>
+<p><a id="revisionHistory"></a></section></section><section><h1><span>Appendix A: Revision History</span></h1></p>
 <table>
 <thead>
 <tr>
diff --git a/oas/v3.0.3.html b/oas/v3.0.3.html
index 44040d185e..699ce3f44e 100644
--- a/oas/v3.0.3.html
+++ b/oas/v3.0.3.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.3 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "},{"name":"Uri Sarid "}],"formerEditors":[{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2020-02-20T00:00:00.000Z","subtitle":"Version 3.0.3","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.0.3 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "}],"formerEditors":[{"name":"Uri Sarid "},{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2020-02-20T00:00:00.000Z","subtitle":"Version 3.0.3","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-831873-42"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
@@ -16,12 +16,12 @@
 <p>An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.</p>
 <!-- /TOC -->
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="oasDocument"><dfn>OpenAPI Document</dfn></span></h4>
+<p><a id="oasDocument"></a><section><h4><span><dfn>OpenAPI Document</dfn></span></h4></p>
 <p>A document (or set of documents) that defines or describes an API. An OpenAPI definition uses and conforms to the OpenAPI Specification.</p>
-</section><section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a></section><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.</p>
 <p>Each template expression in the path MUST correspond to a path parameter that is included in the <a href="#path-item-object">Path Item</a> itself and/or in each of the Path Item’s <a href="#operation-object">Operations</a>.</p>
-</section><section><h4><span id="mediaTypes"><dfn>Media Types</dfn></span></h4>
+<p><a id="mediaTypes"></a></section><section><h4><span><dfn>Media Types</dfn></span></h4></p>
 <p>Media type definitions are spread across several resources.
 The media type definitions SHOULD be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible media type definitions:</p>
@@ -37,7 +37,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation.
 The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the <a href="https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
@@ -51,9 +51,9 @@
 <p>An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.</p>
 <p>For example, if a field has an array value, the JSON array representation will be used:</p>
 <pre class="nohighlight"><code>
-{
-   <span class="hljs-attr">&quot;field&quot;</span>: [ <span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span> ]
-}
+<span class="hljs-punctuation">{</span>
+   <span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span> <span class="hljs-number">1</span><span class="hljs-punctuation">,</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span> <span class="hljs-number">3</span> <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>All field names in the specification are <strong>case sensitive</strong>.
 This includes all fields that are used as keys in a map, except where explicitly noted that keys are <strong>case insensitive</strong>.</p>
@@ -65,10 +65,10 @@
 <li>Keys used in YAML maps MUST be limited to a scalar string, as defined by the <a href="https://yaml.org/spec/1.2/spec.html#id2802346">YAML Failsafe schema ruleset</a>.</li>
 </ul>
 <p><strong>Note:</strong> While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.</p>
-</section><section><h2><span id="documentStructure">Document Structure</span></h2>
+<p><a id="documentStructure"></a></section><section><h2><span>Document Structure</span></h2></p>
 <p>An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the user. In the latter case, <code>$ref</code> fields MUST be used in the specification to reference those parts as follows from the <a href="https://json-schema.org">JSON Schema</a> definitions.</p>
 <p>It is RECOMMENDED that the root OpenAPI document be named: <code>openapi.json</code> or <code>openapi.yaml</code>.</p>
-</section><section><h2><span id="dataTypes">Data Types</span></h2>
+<p><a id="dataTypes"></a></section><section><h2><span>Data Types</span></h2></p>
 <p>Primitive data types in the OAS are based on the types supported by the <a href="https://tools.ietf.org/html/draft-wright-json-schema-00#section-4.2">JSON Schema Specification Wright Draft 00</a>.
 Note that <code>integer</code> as a type is also supported and is defined as a JSON number without a fraction or exponent part.
 <code>null</code> is not supported as a type (see <a href="#schemaNullable"><code>nullable</code></a> for an alternative solution).
@@ -131,12 +131,12 @@
 <tr>
 <td><code>string</code></td>
 <td><code>date</code></td>
-<td>As defined by <code>full-date</code> - [[!RFC3339]]</td>
+<td>As defined by <code>full-date</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td><code>string</code></td>
 <td><code>date-time</code></td>
-<td>As defined by <code>date-time</code> - [[!RFC3339]]</td>
+<td>As defined by <code>date-time</code> - <a href="https://datatracker.ietf.org/doc/html/rfc3339#section-5.6">[!RFC3339]</a></td>
 </tr>
 <tr>
 <td><code>string</code></td>
@@ -145,16 +145,16 @@
 </tr>
 </tbody>
 </table>
-</section><section><h2><span id="richText">Rich Text Formatting</span></h2>
+<p><a id="richText"></a></section><section><h2><span>Rich Text Formatting</span></h2></p>
 <p>Throughout the specification <code>description</code> fields are noted as supporting CommonMark markdown formatting.
 Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by <a href="https://spec.commonmark.org/0.27/">CommonMark 0.27</a>. Tooling MAY choose to ignore some CommonMark features to address security concerns.</p>
-</section><section><h2><span id="relativeReferences">Relative References in URLs</span></h2>
+<p><a id="relativeReferences"></a></section><section><h2><span>Relative References in URLs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]].
 Relative references are resolved using the URLs defined in the <a href="#serverObject"><code>Server Object</code></a> as a Base URI.</p>
 <p>Relative references used in <code>$ref</code> are processed as per <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a>, using the URL of the current document as the base URI. See also the <a href="#referenceObject">Reference Object</a>.</p>
 </section><section><h2>Schema</h2>
 <p>In the following description, if a field is not explicitly <strong>REQUIRED</strong> or described with a MUST or SHALL, it can be considered OPTIONAL.</p>
-<section><h3><span id="oasObject">OpenAPI Object</span></h3>
+<p><a id="oasObject"></a><section><h3><span>OpenAPI Object</span></h3></p>
 <p>This is the root document object of the <a href="#oasDocument">OpenAPI document</a>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -209,7 +209,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API.
 The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.</p>
 <section><h4>Fixed Fields</h4>
@@ -257,21 +257,21 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Info Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;Sample Pet Store App&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span>,
-  <span class="hljs-attr">&quot;termsOfService&quot;</span>: <span class="hljs-string">&quot;http://example.com/terms/&quot;</span>,
-  <span class="hljs-attr">&quot;contact&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-    <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-  },
-  <span class="hljs-attr">&quot;license&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-  },
-  <span class="hljs-attr">&quot;version&quot;</span>: <span class="hljs-string">&quot;1.0.1&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;title&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Sample Pet Store App&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;termsOfService&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/terms/&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;contact&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;license&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;version&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;1.0.1&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">title:</span> <span class="hljs-string">Sample</span> <span class="hljs-string">Pet</span> <span class="hljs-string">Store</span> <span class="hljs-string">App</span>
@@ -286,7 +286,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -318,18 +318,18 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Contact Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;http://www.example.com/support&quot;</span>,
-  <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">API</span> <span class="hljs-string">Support</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">http://www.example.com/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@example.com</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -356,16 +356,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>License Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 </code></pre>
-</section></section><section><h3><span id="serverObject">Server Object</span></h3>
+<p><a id="serverObject"></a></section></section><section><h3><span>Server Object</span></h3></p>
 <p>An object representing a Server.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -398,10 +398,10 @@
 </section><section><h4>Server Object Example</h4>
 <p>A single server would be described as:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://development.gigantic-server.com/v1</span>
@@ -409,22 +409,22 @@
 </code></pre>
 <p>The following shows how multiple servers can be described, for example, at the OpenAPI Object’s <a href="#oasServers"><code>servers</code></a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Staging server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Production server&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Staging server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Production server&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -437,30 +437,30 @@
 </code></pre>
 <p>The following shows how variables can be used for a server configuration:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The production API server&quot;</span>,
-      <span class="hljs-attr">&quot;variables&quot;</span>: {
-        <span class="hljs-attr">&quot;username&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;demo&quot;</span>,
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
-        },
-        <span class="hljs-attr">&quot;port&quot;</span>: {
-          <span class="hljs-attr">&quot;enum&quot;</span>: [
-            <span class="hljs-string">&quot;8443&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The production API server&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;variables&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;username&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;demo&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;port&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+            <span class="hljs-string">&quot;8443&quot;</span><span class="hljs-punctuation">,</span>
             <span class="hljs-string">&quot;443&quot;</span>
-          ],
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;8443&quot;</span>
-        },
-        <span class="hljs-attr">&quot;basePath&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;v2&quot;</span>
-        }
-      }
-    }
-  ]
-}
+          <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;8443&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;basePath&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;v2&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -480,7 +480,7 @@
       <span class="hljs-comment"># open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`</span>
       <span class="hljs-attr">default:</span> <span class="hljs-string">v2</span>
 </code></pre>
-</section></section><section><h3><span id="serverVariableObject">Server Variable Object</span></h3>
+<p><a id="serverVariableObject"></a></section></section><section><h3><span>Server Variable Object</span></h3></p>
 <p>An object representing a Server Variable for server URL template substitution.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -510,7 +510,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="componentsObject">Components Object</span></h3>
+<p><a id="componentsObject"></a></section></section><section><h3><span>Components Object</span></h3></p>
 <p>Holds a set of reusable objects for different aspects of the OAS.
 All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.</p>
 <section><h4>Fixed Fields</h4>
@@ -582,105 +582,105 @@
 </code></pre>
 </section><section><h4>Components Object Example</h4>
 <pre class="nohighlight"><code>
-&quot;components&quot;: {
-  &quot;schemas&quot;: {
-    &quot;GeneralError&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;code&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int32&quot;
-        },
-        &quot;message&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Category&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Tag&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    }
-  },
-  &quot;parameters&quot;: {
-    &quot;skipParam&quot;: {
-      &quot;name&quot;: &quot;skip&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;number of items to skip&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot;: {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    },
-    &quot;limitParam&quot;: {
-      &quot;name&quot;: &quot;limit&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;max records to return&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot; : {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    }
-  },
-  &quot;responses&quot;: {
-    &quot;NotFound&quot;: {
-      &quot;description&quot;: &quot;Entity not found.&quot;
-    },
-    &quot;IllegalInput&quot;: {
-      &quot;description&quot;: &quot;Illegal input for operation.&quot;
-    },
-    &quot;GeneralError&quot;: {
-      &quot;description&quot;: &quot;General Error&quot;,
-      &quot;content&quot;: {
-        &quot;application/json&quot;: {
-          &quot;schema&quot;: {
-            &quot;$ref&quot;: &quot;#/components/schemas/GeneralError&quot;
-          }
-        }
-      }
-    }
-  },
-  &quot;securitySchemes&quot;: {
-    &quot;api_key&quot;: {
-      &quot;type&quot;: &quot;apiKey&quot;,
-      &quot;name&quot;: &quot;api_key&quot;,
-      &quot;in&quot;: &quot;header&quot;
-    },
-    &quot;petstore_auth&quot;: {
-      &quot;type&quot;: &quot;oauth2&quot;,
-      &quot;flows&quot;: {
-        &quot;implicit&quot;: {
-          &quot;authorizationUrl&quot;: &quot;http://example.org/api/oauth/dialog&quot;,
-          &quot;scopes&quot;: {
-            &quot;write:pets&quot;: &quot;modify pets in your account&quot;,
-            &quot;read:pets&quot;: &quot;read your pets&quot;
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Category&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Tag&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;skipParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number of items to skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;limitParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;limit&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;max records to return&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;NotFound&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Entity not found.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;IllegalInput&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Illegal input for operation.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;General Error&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/GeneralError&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;securitySchemes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.org/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -751,7 +751,7 @@
             <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
             <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints and their operations.
 The path is appended to the URL from the <a href="#serverObject"><code>Server Object</code></a> in order to construct the full URL.  The Paths MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -790,28 +790,28 @@
 </code></pre>
 </section><section><h4>Paths Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;/pets&quot;</span>: {
-    <span class="hljs-attr">&quot;get&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span>,
-      <span class="hljs-attr">&quot;responses&quot;</span>: {
-        <span class="hljs-attr">&quot;200&quot;</span>: {          
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A list of pets.&quot;</span>,
-          <span class="hljs-attr">&quot;content&quot;</span>: {
-            <span class="hljs-attr">&quot;application/json&quot;</span>: {
-              <span class="hljs-attr">&quot;schema&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-                <span class="hljs-attr">&quot;items&quot;</span>: {
-                  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;/pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>          
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A list of pets.&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
+                <span class="hljs-punctuation">}</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">/pets:</span>
@@ -827,7 +827,7 @@
               <span class="hljs-attr">items:</span>
                 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.
 The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
@@ -911,53 +911,53 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Path Item Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;get&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns pets based on ID&quot;</span>,
-    <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Find pets by ID&quot;</span>,
-    <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;getPetsById&quot;</span>,
-    <span class="hljs-attr">&quot;responses&quot;</span>: {
-      <span class="hljs-attr">&quot;200&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;pet response&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;*/*&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-              <span class="hljs-attr">&quot;items&quot;</span>: {
-                <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-              }
-            }
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;default&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;error payload&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;text/html&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-            }
-          }
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet to use&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      },
-      <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns pets based on ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find pets by ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;getPetsById&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet response&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;error payload&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;text/html&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet to use&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">get:</span>
@@ -990,7 +990,7 @@
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>  
   <span class="hljs-attr">style:</span> <span class="hljs-string">simple</span>
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1067,68 +1067,68 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Operation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;tags&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;tags&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;pet&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span>,
-  <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;updatePetWithForm&quot;</span>,
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;petId&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  ],
-  <span class="hljs-attr">&quot;requestBody&quot;</span>: {
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-          <span class="hljs-attr">&quot;properties&quot;</span>: {
-            <span class="hljs-attr">&quot;name&quot;</span>: { 
-              <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated name of the pet&quot;</span>,
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-            },
-            <span class="hljs-attr">&quot;status&quot;</span>: {
-              <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated status of the pet&quot;</span>,
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-            }
-          },
-          <span class="hljs-attr">&quot;required&quot;</span>: [<span class="hljs-string">&quot;status&quot;</span>] 
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;responses&quot;</span>: {
-    <span class="hljs-attr">&quot;200&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pet updated.&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    },
-    <span class="hljs-attr">&quot;405&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Method Not Allowed&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;updatePetWithForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petId&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;requestBody&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span> 
+              <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated name of the pet&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;status&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated status of the pet&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-string">&quot;status&quot;</span><span class="hljs-punctuation">]</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet updated.&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;405&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Method Not Allowed&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">tags:</span>
@@ -1171,7 +1171,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1198,16 +1198,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>External Documentation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Find more info here&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find more info here&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://example.com</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <section><h4>Parameter Locations</h4>
@@ -1492,20 +1492,20 @@
 </section><section><h4>Parameter Object Examples</h4>
 <p>A header parameter with an array of 64 bit integer numbers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;token&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;token to be passed as a header&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token to be passed as a header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">token</span>
@@ -1521,15 +1521,15 @@
 </code></pre>
 <p>A path parameter of a string value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;username&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;username to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">username</span>
@@ -1541,20 +1541,20 @@
 </code></pre>
 <p>An optional query parameter of a string value, allowing multiple values by repeating the query parameter:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of the object to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">false</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>,
-  <span class="hljs-attr">&quot;explode&quot;</span>: <span class="hljs-literal">true</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of the object to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;explode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">id</span>
@@ -1570,17 +1570,17 @@
 </code></pre>
 <p>A free-form query parameter, allowing undefined parameters of a specific type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;freeForm&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-    },
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;freeForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1593,29 +1593,29 @@
 </code></pre>
 <p>A complex parameter using <code>content</code> to define serialization:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;coordinates&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;lat&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;coordinates&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;lat&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;long&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;lat&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          },
-          <span class="hljs-attr">&quot;long&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          }
-        }
-      }
-    }
-  }
-}
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;lat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;long&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1633,7 +1633,7 @@
         <span class="hljs-attr">long:</span>
           <span class="hljs-attr">type:</span> <span class="hljs-string">number</span>
 </code></pre>
-</section></section><section><h3><span id="requestBodyObject">Request Body Object</span></h3>
+<p><a id="requestBodyObject"></a></section></section><section><h3><span>Request Body Object</span></h3></p>
 <p>Describes a single request body.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1653,7 +1653,7 @@
 <tr>
 <td><a id="requestBodyContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="requestBodyRequired"> </a>required</td>
@@ -1666,49 +1666,49 @@
 </section><section><h4>Request Body Examples</h4>
 <p>A request body with a referenced model definition.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User Example&quot;</span>, 
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
-          } 
-        }
-    },
-    <span class="hljs-attr">&quot;application/xml&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in XML&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
-          }
-        }
-    },
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in Plain text&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
-        }
-      } 
-    },
-    <span class="hljs-attr">&quot;*/*&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in other format&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User Example&quot;</span><span class="hljs-punctuation">,</span> 
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.json&quot;</span>
+          <span class="hljs-punctuation">}</span> 
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in XML&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.xml&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in Plain text&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.txt&quot;</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span> 
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in other format&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://foo.bar/examples/user-example.whatever&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1740,19 +1740,19 @@
 </code></pre>
 <p>A body parameter that is an array of string values:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1764,7 +1764,7 @@
       <span class="hljs-attr">items:</span>
         <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="mediaTypeObject">Media Type Object</span></h3>
+<p><a id="mediaTypeObject"></a></section></section><section><h3><span>Media Type Object</span></h3></p>
 <p>Each Media Type Object provides schema and examples for the media type identified by its key.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1801,39 +1801,39 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Media Type Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;application/json&quot;</span>: {
-    <span class="hljs-attr">&quot;schema&quot;</span>: {
-         <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-    },
-    <span class="hljs-attr">&quot;examples&quot;</span>: {
-      <span class="hljs-attr">&quot;cat&quot;</span> : {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a cat&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span>: 
-          {
-            <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Fluffy&quot;</span>,
-            <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-            <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;White&quot;</span>,
-            <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;male&quot;</span>,
-            <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Persian&quot;</span>
-          }
-      },
-      <span class="hljs-attr">&quot;dog&quot;</span>: {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span> :  { 
-          <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-          <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Dog&quot;</span>,
-          <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;Black&quot;</span>,
-          <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;Female&quot;</span>,
-          <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Mixed&quot;</span>
-        },
-      <span class="hljs-attr">&quot;frog&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+         <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;cat&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a cat&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span><span class="hljs-punctuation">:</span> 
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Fluffy&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;White&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;male&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Persian&quot;</span>
+          <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span> <span class="hljs-punctuation">:</span>  <span class="hljs-punctuation">{</span> 
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Dog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Black&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Female&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Mixed&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;frog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">application/json:</span> 
@@ -1973,7 +1973,7 @@
               <span class="hljs-attr">type:</span> <span class="hljs-string">&#x27;#/components/schemas/Address&#x27;</span>
 </code></pre>
 <p>An <code>encoding</code> attribute is introduced to give you control over the serialization of parts of <code>multipart</code> request bodies.  This attribute is <em>only</em> applicable to <code>multipart</code> and <code>application/x-www-form-urlencoded</code> request bodies.</p>
-</section></section><section><h3><span id="encodingObject">Encoding Object</span></h3>
+<p><a id="encodingObject"></a></section></section><section><h3><span>Encoding Object</span></h3></p>
 <p>A single encoding definition applied to a single schema property.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2051,7 +2051,7 @@
               <span class="hljs-attr">schema:</span>
                 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.</p>
 <p>The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
@@ -2098,28 +2098,28 @@
 </section><section><h4>Responses Object Example</h4>
 <p>A 200 response for a successful operation and a default response for others (implying an error):</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;200&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;a pet to be returned&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;default&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Unexpected error&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;a pet to be returned&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Unexpected error&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">&#x27;200&#x27;:</span>
@@ -2135,7 +2135,7 @@
       <span class="hljs-attr">schema:</span>
         <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation, including design-time, static
 <code>links</code> to operations based on the response.</p>
 <section><h4>Fixed Fields</h4>
@@ -2161,7 +2161,7 @@
 <tr>
 <td><a id="responseContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="responseLinks"> </a>links</td>
@@ -2174,19 +2174,19 @@
 </section><section><h4>Response Object Examples</h4>
 <p>Response of an array of a complex type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A complex object array response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A complex object array response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">complex</span> <span class="hljs-string">object</span> <span class="hljs-string">array</span> <span class="hljs-string">response</span>
@@ -2199,17 +2199,17 @@
 </code></pre>
 <p>Response with a string type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  }
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
 
-}
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2220,37 +2220,37 @@
 </code></pre>
 <p>Plain text response with headers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;example&quot;</span>: <span class="hljs-string">&quot;whoa!&quot;</span>
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;headers&quot;</span>: {
-    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;whoa!&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;headers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2275,14 +2275,14 @@
 </code></pre>
 <p>Response with no return value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;object created&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object created&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="callbackObject">Callback Object</span></h3>
+<p><a id="callbackObject"></a></section></section><section><h3><span>Callback Object</span></h3></p>
 <p>A map of possible out-of band callbacks related to the parent operation.
 Each value in the map is a <a href="#pathItemObject">Path Item Object</a> that describes a set of requests that may be initiated by the API provider and the expected responses.
 The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.</p>
@@ -2316,7 +2316,7 @@
 <span class="hljs-attribute">Content-Type</span><span class="hljs-punctuation">: </span>application/json
 <span class="hljs-attribute">Content-Length</span><span class="hljs-punctuation">: </span>187
 
-<span class="awk">{
+<span class="language-avrasm">{
   <span class="hljs-string">&quot;failedUrl&quot;</span> : <span class="hljs-string">&quot;http://clientdomain.com/failed&quot;</span>,
   <span class="hljs-string">&quot;successUrls&quot;</span> : [
     <span class="hljs-string">&quot;http://clientdomain.com/fast&quot;</span>,
@@ -2326,7 +2326,7 @@
 }
 
 <span class="hljs-number">201</span> Created
-Location: http:<span class="hljs-regexp">//</span>example.org<span class="hljs-regexp">/subscription/</span><span class="hljs-number">1</span>
+<span class="hljs-symbol">Location:</span> http://example<span class="hljs-meta">.org</span>/subscription/<span class="hljs-number">1</span>
 </span></code></pre>
 <p>The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named <code>eventType</code> and a query parameter named <code>queryUrl</code>.</p>
 <table>
@@ -2402,7 +2402,7 @@
         <span class="hljs-attr">&#x27;200&#x27;:</span>
           <span class="hljs-attr">description:</span> <span class="hljs-string">callback</span> <span class="hljs-string">successfully</span> <span class="hljs-string">processed</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <section><h4>Fixed Fields</h4>
 <table>
 <thead>
@@ -2490,7 +2490,7 @@
           <span class="hljs-attr">confirmation-success:</span>
             <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/examples/confirmation-success&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="linkObject">Link Object</span></h3>
+<p><a id="linkObject"></a></section></section><section><h3><span>Link Object</span></h3></p>
 <p>The <code>Link object</code> represents a possible design-time link for a response.
 The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.</p>
 <p>Unlike <em>dynamic</em> links (i.e. links provided <strong>in</strong> the response payload), the OAS linking mechanism does not require link information in the runtime response.</p>
@@ -2624,32 +2624,32 @@
 </code></pre>
 <p>Note that in the use of <code>operationRef</code>, the <em>escaped forward-slash</em> is necessary when
 using JSON references.</p>
-</section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4>
+<p><a id="runtimeExpression"></a></section><section><h4><span>Runtime Expressions</span></h4></p>
 <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call.
 This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p>
-<p>The runtime expression is defined by the following [ABNF] syntax</p>
-<pre class="nohighlight"><code>
-      expression = ( <span class="hljs-string">&quot;$url&quot;</span> / <span class="hljs-string">&quot;$method&quot;</span> / <span class="hljs-string">&quot;$statusCode&quot;</span> / <span class="hljs-string">&quot;$request.&quot;</span> source / <span class="hljs-string">&quot;$response.&quot;</span> source )
-      source = ( header-reference / query-reference / path-reference / body-reference )
-      header-reference = <span class="hljs-string">&quot;header.&quot;</span> token
-      query-reference = <span class="hljs-string">&quot;query.&quot;</span> name  
-      path-reference = <span class="hljs-string">&quot;path.&quot;</span> name
-      body-reference = <span class="hljs-string">&quot;body&quot;</span> [<span class="hljs-string">&quot;#&quot;</span> json-pointer ]
-      json-pointer    = *( <span class="hljs-string">&quot;/&quot;</span> reference-token )
-      reference-token = *( unescaped / escaped )
-      unescaped       = <span class="hljs-symbol">%x00-2E</span> / <span class="hljs-symbol">%x30-7D</span> / <span class="hljs-symbol">%x7F-10FFFF</span>
+<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p>
+<pre class="nohighlight"><code>
+      expression <span class="hljs-operator">=</span> ( <span class="hljs-string">&quot;$url&quot;</span> / <span class="hljs-string">&quot;$method&quot;</span> / <span class="hljs-string">&quot;$statusCode&quot;</span> / <span class="hljs-string">&quot;$request.&quot;</span> source / <span class="hljs-string">&quot;$response.&quot;</span> source )
+      source <span class="hljs-operator">=</span> ( header-reference / query-reference / path-reference / body-reference )
+      header-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;header.&quot;</span> token
+      query-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;query.&quot;</span> name  
+      path-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;path.&quot;</span> name
+      body-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;body&quot;</span> [<span class="hljs-string">&quot;#&quot;</span> json-pointer ]
+      json-pointer    <span class="hljs-operator">=</span> *( <span class="hljs-string">&quot;/&quot;</span> reference-token )
+      reference-token <span class="hljs-operator">=</span> *( unescaped / escaped )
+      unescaped       <span class="hljs-operator">=</span> <span class="hljs-symbol">%x00-2E</span> / <span class="hljs-symbol">%x30-7D</span> / <span class="hljs-symbol">%x7F-10FFFF</span>
          <span class="hljs-comment">; %x2F (&#x27;/&#x27;) and %x7E (&#x27;~&#x27;) are excluded from &#x27;unescaped&#x27;</span>
-      escaped         = <span class="hljs-string">&quot;~&quot;</span> ( <span class="hljs-string">&quot;0&quot;</span> / <span class="hljs-string">&quot;1&quot;</span> )
+      escaped         <span class="hljs-operator">=</span> <span class="hljs-string">&quot;~&quot;</span> ( <span class="hljs-string">&quot;0&quot;</span> / <span class="hljs-string">&quot;1&quot;</span> )
         <span class="hljs-comment">; representing &#x27;~&#x27; and &#x27;/&#x27;, respectively</span>
-      name = *( <span class="hljs-keyword">CHAR</span> )
-      token = <span class="hljs-number">1</span>*tchar
-      tchar = <span class="hljs-string">&quot;!&quot;</span> / <span class="hljs-string">&quot;#&quot;</span> / <span class="hljs-string">&quot;$&quot;</span> / <span class="hljs-string">&quot;%&quot;</span> / <span class="hljs-string">&quot;&amp;&quot;</span> / <span class="hljs-string">&quot;&#x27;&quot;</span> / <span class="hljs-string">&quot;*&quot;</span> / <span class="hljs-string">&quot;+&quot;</span> / <span class="hljs-string">&quot;-&quot;</span> / <span class="hljs-string">&quot;.&quot;</span> /
+      name <span class="hljs-operator">=</span> *( <span class="hljs-keyword">CHAR</span> )
+      token <span class="hljs-operator">=</span> <span class="hljs-number">1</span>*tchar
+      tchar <span class="hljs-operator">=</span> <span class="hljs-string">&quot;!&quot;</span> / <span class="hljs-string">&quot;#&quot;</span> / <span class="hljs-string">&quot;$&quot;</span> / <span class="hljs-string">&quot;%&quot;</span> / <span class="hljs-string">&quot;&amp;&quot;</span> / <span class="hljs-string">&quot;&#x27;&quot;</span> / <span class="hljs-string">&quot;*&quot;</span> / <span class="hljs-string">&quot;+&quot;</span> / <span class="hljs-string">&quot;-&quot;</span> / <span class="hljs-string">&quot;.&quot;</span> /
         <span class="hljs-string">&quot;^&quot;</span> / <span class="hljs-string">&quot;_&quot;</span> / <span class="hljs-string">&quot;`&quot;</span> / <span class="hljs-string">&quot;|&quot;</span> / <span class="hljs-string">&quot;~&quot;</span> / <span class="hljs-keyword">DIGIT</span> / <span class="hljs-keyword">ALPHA</span>
 </code></pre>
 <p>Here, <code>json-pointer</code> is taken from [[!RFC6901]], <code>char</code> from [[!RFC7159]] and <code>token</code> from [[!RFC7230]].</p>
 <p>The <code>name</code> identifier is case-sensitive, whereas <code>token</code> is not.</p>
 <p>The table below provides examples of runtime expressions and examples of their use in a value:</p>
-</section><section><h4><span id="runtimeExpressionExamples">Examples</span></h4>
+<p><a id="runtimeExpressionExamples"></a></section><section><h4><span>Examples</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2698,7 +2698,7 @@
 </table>
 <p>Runtime expressions preserve the type of the referenced value.
 Expressions can be embedded into string values by surrounding the expression with <code>{}</code> curly braces.</p>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <p>The Header Object follows the structure of the <a href="#parameterObject">Parameter Object</a> with the following changes:</p>
 <ol>
 <li><code>name</code> MUST NOT be specified, it is given in the corresponding <code>headers</code> map.</li>
@@ -2708,19 +2708,19 @@
 <section><h4>Header Object Example</h4>
 <p>A simple header of type <code>integer</code>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">schema:</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Adds metadata to a single tag that is used by the <a href="#operationObject">Operation Object</a>.
 It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.</p>
 <section><h4>Fixed Fields</h4>
@@ -2753,16 +2753,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Tag Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;pet&quot;</span>,
-	<span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pets operations&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet&quot;</span><span class="hljs-punctuation">,</span>
+	<span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pets operations&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other components in the specification, internally and externally.</p>
 <p>The Reference Object is defined by <a href="https://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03">JSON Reference</a> and follows the same structure, behavior and rules.</p>
 <p>For this specification, reference resolution is accomplished as defined by the JSON Reference specification and not by the JSON Schema specification.</p>
@@ -2786,32 +2786,32 @@
 <p>This object cannot be extended with additional properties and any properties added SHALL be ignored.</p>
 </section><section><h4>Reference Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Pet&#x27;</span>
 </code></pre>
 </section><section><h4>Relative Schema Document Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;Pet.json&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet.json&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">Pet.yaml</span>
 </code></pre>
 </section><section><h4>Relative Documents With Embedded Schema Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">definitions.yaml#/Pet</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types.
 These types can be objects, but also primitives and arrays.
 This object is an extended subset of the <a href="https://json-schema.org/">JSON Schema Specification Wright Draft 00</a>.</p>
@@ -2907,7 +2907,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-<section><h5><span id="schemaComposition">Composition and Inheritance (Polymorphism)</span></h5>
+<p><a id="schemaComposition"></a><section><h5><span>Composition and Inheritance (Polymorphism)</span></h5></p>
 <p>The OpenAPI Specification allows combining and extending model definitions using the <code>allOf</code> property of JSON Schema, in effect offering model composition.
 <code>allOf</code> takes an array of object definitions that are validated <em>independently</em> but together compose a single object.</p>
 <p>While composition offers model extensibility, it does not imply a hierarchy between the models.
@@ -2926,10 +2926,10 @@
 </section></section><section><h4>Schema Object Examples</h4>
 <section><h5>Primitive Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-  <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;email&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;email&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
@@ -2937,25 +2937,25 @@
 </code></pre>
 </section><section><h5>Simple Model</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;address&quot;</span>: {
-      <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
-    },
-    <span class="hljs-attr">&quot;age&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-      <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-    }
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;address&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;age&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2974,12 +2974,12 @@
 </section><section><h5>Model with Map/Dictionary Properties</h5>
 <p>For a simple string to string mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2988,12 +2988,12 @@
 </code></pre>
 <p>For a string to model mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3002,25 +3002,25 @@
 </code></pre>
 </section><section><h5>Model with Example</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;id&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    },
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;example&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-    <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">1</span>
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3038,47 +3038,47 @@
 </code></pre>
 </section><section><h5>Models with Composition</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;ErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;message&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;ErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;message&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;code&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;message&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;code&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-            <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">100</span>,
-            <span class="hljs-attr">&quot;maximum&quot;</span>: <span class="hljs-number">600</span>
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">100</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;maximum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">600</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;rootCause&quot;</span>
-            ],
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;rootCause&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;rootCause&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3107,80 +3107,80 @@
 </code></pre>
 </section><section><h5>Models with Polymorphism Support</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;Pet&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;discriminator&quot;</span>: {
-          <span class="hljs-attr">&quot;propertyName&quot;</span>: <span class="hljs-string">&quot;petType&quot;</span>
-        },
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;name&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;petType&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          }
-        },
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;name&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;Pet&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;discriminator&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;propertyName&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petType&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;name&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;petType&quot;</span>
-        ]
-      },
-      <span class="hljs-attr">&quot;Cat&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;huntingSkill&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The measured skill for hunting&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;lazy&quot;</span>,
-                <span class="hljs-attr">&quot;enum&quot;</span>: [
-                  <span class="hljs-string">&quot;clueless&quot;</span>,
-                  <span class="hljs-string">&quot;lazy&quot;</span>,
-                  <span class="hljs-string">&quot;adventurous&quot;</span>,
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Cat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;huntingSkill&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The measured skill for hunting&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+                  <span class="hljs-string">&quot;clueless&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;adventurous&quot;</span><span class="hljs-punctuation">,</span>
                   <span class="hljs-string">&quot;aggressive&quot;</span>
-                ]
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+                <span class="hljs-punctuation">]</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;huntingSkill&quot;</span>
-            ]
-          }
-        ]
-      },
-      <span class="hljs-attr">&quot;Dog&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;packSize&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-                <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-number">0</span>,
-                <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;packSize&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;packSize&quot;</span>
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3228,7 +3228,7 @@
         <span class="hljs-attr">required:</span>
         <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="discriminatorObject">Discriminator Object</span></h3>
+<p><a id="discriminatorObject"></a></section></section></section><section><h3><span>Discriminator Object</span></h3></p>
 <p>When request bodies or response payloads may be one of a number of different schemas, a <code>discriminator</code> object can be used to aid in serialization, deserialization, and validation.  The discriminator is a specific object in a schema which is used to inform the consumer of the specification of an alternative schema based on the value associated with it.</p>
 <p>When using the discriminator, <em>inline</em> schemas will not be considered.</p>
 <section><h4>Fixed Fields</h4>
@@ -3274,10 +3274,10 @@
 </code></pre>
 <p>The expectation now is that a property with name <code>petType</code> <em>MUST</em> be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document.  Thus the response payload:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">12345</span>,
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">12345</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>Will indicate that the <code>Cat</code> schema be used in conjunction with this payload.</p>
 <p>In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional <code>mapping</code> definition MAY be used:</p>
@@ -3339,20 +3339,20 @@
 </code></pre>
 <p>a payload like this:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;misty&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;misty&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will indicate that the <code>Cat</code> schema be used.  Likewise this schema:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;dog&quot;</span>,
-  <span class="hljs-attr">&quot;bark&quot;</span>: <span class="hljs-string">&quot;soft&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;dog&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bark&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;soft&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will map to <code>Dog</code> because of the definition in the <code>mappings</code> element.</p>
-</section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property SHOULD be used to add that information.
 See examples for expected behavior.</p>
@@ -3399,11 +3399,11 @@
 <section><h5>No XML Element</h5>
 <p>Basic string property:</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3414,14 +3414,14 @@
 </code></pre>
 <p>Basic string array property (<a href="#xmlWrapped"><code>wrapped</code></a> is <code>false</code> by default):</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3436,14 +3436,14 @@
 </code></pre>
 </section><section><h5>XML Name Replacement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3457,27 +3457,27 @@
 </section><section><h5>XML Attribute, Prefix and Namespace</h5>
 <p>In this example, a full model definition is shown.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;Person&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;properties&quot;</span>: {
-      <span class="hljs-attr">&quot;id&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-        <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;attribute&quot;</span>: <span class="hljs-literal">true</span>
-        }
-      },
-      <span class="hljs-attr">&quot;name&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;namespace&quot;</span>: <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span>,
-          <span class="hljs-attr">&quot;prefix&quot;</span>: <span class="hljs-string">&quot;sample&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;Person&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;attribute&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;namespace&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http://example.com/schema/sample&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;prefix&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;sample&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">Person:</span>
@@ -3502,17 +3502,17 @@
 </section><section><h5>XML Arrays</h5>
 <p>Changing the element names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3528,20 +3528,20 @@
 </code></pre>
 <p>The external <code>name</code> property has no effect on the XML:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3559,17 +3559,17 @@
 </code></pre>
 <p>Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3587,20 +3587,20 @@
 </code></pre>
 <p>To overcome the naming problem in the example above, the following definition can be used:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3620,21 +3620,21 @@
 </code></pre>
 <p>Affecting both internal and external names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3655,18 +3655,18 @@
 </code></pre>
 <p>If we change the external element but not the internal ones:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3683,7 +3683,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Defines a security scheme that can be used by the operations.
 Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and <a href="https://tools.ietf.org/html/draft-ietf-oauth-discovery-06">OpenID Connect Discovery</a>.</p>
 <section><h4>Fixed Fields</h4>
@@ -3751,10 +3751,10 @@
 </section><section><h4>Security Scheme Object Example</h4>
 <section><h5>Basic Authentication Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;basic&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;basic&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3762,11 +3762,11 @@
 </code></pre>
 </section><section><h5>API Key Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;apiKey&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;api_key&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">apiKey</span>
@@ -3775,11 +3775,11 @@
 </code></pre>
 </section><section><h5>JWT Bearer Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;bearer&quot;</span>,
-  <span class="hljs-attr">&quot;bearerFormat&quot;</span>: <span class="hljs-string">&quot;JWT&quot;</span>,
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;bearer&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bearerFormat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;JWT&quot;</span><span class="hljs-punctuation">,</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3788,18 +3788,18 @@
 </code></pre>
 </section><section><h5>Implicit OAuth2 Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3810,7 +3810,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="oauthFlowsObject">OAuth Flows Object</span></h3>
+<p><a id="oauthFlowsObject"></a></section></section></section><section><h3><span>OAuth Flows Object</span></h3></p>
 <p>Allows configuration of the supported OAuth Flows.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3845,7 +3845,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="oauthFlowObject">OAuth Flow Object</span></h3>
+<p><a id="oauthFlowObject"></a></section></section><section><h3><span>OAuth Flow Object</span></h3></p>
 <p>Configuration details for a supported OAuth Flow</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3887,26 +3887,26 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>OAuth Flow Object Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;authorizationCode&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;tokenUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;authorizationCode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;tokenUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3923,7 +3923,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span> 
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation.
 The name used for each property MUST correspond to a security scheme declared in the <a href="#componentsSecuritySchemes">Security Schemes</a> under the <a href="#componentsObject">Components Object</a>.</p>
 <p>Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
@@ -3949,21 +3949,21 @@
 </section><section><h4>Security Requirement Object Examples</h4>
 <section><h5>Non-OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;api_key&quot;</span>: []
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">api_key:</span> []
 </code></pre>
 </section><section><h5>OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-    <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
     <span class="hljs-string">&quot;read:pets&quot;</span>
-  ]
-}
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">petstore_auth:</span>
@@ -3973,17 +3973,17 @@
 </section><section><h5>Optional OAuth2 Security</h5>
 <p>Optional OAuth2 security as would be defined in an <a href="#openapi-object">OpenAPI Object</a> or an <a href="#operation-object">Operation Object</a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {},
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">security:</span>
@@ -3992,7 +3992,7 @@
     <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
     <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="specificationExtensions">Specification Extensions</span></h2>
+<p><a id="specificationExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are implemented as patterned fields that are always prefixed by <code>&quot;x-&quot;</code>.</p>
 <table>
@@ -4012,7 +4012,7 @@
 </tbody>
 </table>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning is to allow an additional layer of access control over the documentation.
 While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
@@ -4021,7 +4021,7 @@
 <li>The <a href="#pathsObject">Paths Object</a> MAY be empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They’d still have access to the <a href="#infoObject">Info Object</a> which may contain additional information regarding authentication.</li>
 <li>The <a href="#pathItemObject">Path Item Object</a> MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the <a href="#pathsObject">Paths Object</a>, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.</li>
 </ol>
-</section></section><section><h1><span id="revisionHistory">Appendix A: Revision History</span></h1>
+<p><a id="revisionHistory"></a></section></section><section><h1><span>Appendix A: Revision History</span></h1></p>
 <table>
 <thead>
 <tr>
diff --git a/oas/v3.1.0.html b/oas/v3.1.0.html
index fca28102c4..0b173d3366 100644
--- a/oas/v3.1.0.html
+++ b/oas/v3.1.0.html
@@ -1,4 +1,4 @@
-<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.1.0 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "},{"name":"Uri Sarid "}],"formerEditors":[{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2021-02-15T00:00:00.000Z","subtitle":"Version 3.1.0","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
+<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><title>OpenAPI Specification v3.1.0 | Introduction, Definitions, &amp; More</title><meta name="description" content="The OpenAPI Specification (OAS) defines a standard, programming language-agnostic interface description for HTTP APIs."><link rel="canonical" href="https://spec.openapis.org/oas/latest.html" /><script src="../js/respec-oai.js" class="remove"></script><script class="remove">var respecConfig = {"specStatus":"base","editors":[{"name":"Darrel Miller "},{"name":"Jeremy Whitlock "},{"name":"Marsh Gardiner "},{"name":"Mike Ralphson "},{"name":"Ron Ratovsky "}],"formerEditors":[{"name":"Uri Sarid "},{"name":"Jason Harmon "},{"name":"Tony Tam "}],"publishDate":"2021-02-15T00:00:00.000Z","subtitle":"Version 3.1.0","processVersion":2017,"edDraftURI":"https://github.com/OAI/OpenAPI-Specification/","github":{"repoURL":"https://github.com/OAI/OpenAPI-Specification/","branch":"master"},"shortName":"OAS","noTOC":false,"lint":false,"additionalCopyrightHolders":"the Linux Foundation","includePermalinks":true};</script><!-- Global site tag (gtag.js) - Google Analytics -->
 <script async src="https://www.googletagmanager.com/gtag/js?id=UA-831873-42"></script>
 <script>
  window.dataLayer = window.dataLayer || [];
@@ -16,13 +16,13 @@
 <p>An OpenAPI definition can then be used by documentation generation tools to display the API, code generation tools to generate servers and clients in various programming languages, testing tools, and many other use cases.</p>
 <!-- /TOC -->
 </section><section><h1><dfn>Definitions</dfn></h1>
-<section><h4><span id="oasDocument"><dfn>OpenAPI Document</dfn></span></h4>
+<p><a id="oasDocument"></a><section><h4><span><dfn>OpenAPI Document</dfn></span></h4></p>
 <p>A self-contained or composite resource which defines or describes an API or elements of an API. The OpenAPI document MUST contain at least one <a href="#pathsObject">paths</a> field, a <a href="#oasComponents">components</a> field or a <a href="#oasWebhooks">webhooks</a> field. An OpenAPI document uses and conforms to the OpenAPI Specification.</p>
-</section><section><h4><span id="pathTemplating"><dfn>Path Templating</dfn></span></h4>
+<p><a id="pathTemplating"></a></section><section><h4><span><dfn>Path Templating</dfn></span></h4></p>
 <p>Path templating refers to the usage of template expressions, delimited by curly braces ({}), to mark a section of a URL path as replaceable using path parameters.</p>
 <p>Each template expression in the path MUST correspond to a path parameter that is included in the <a href="#path-item-object">Path Item</a> itself and/or in each of the Path Item’s <a href="#operation-object">Operations</a>. An exception is if the path item is empty, for example due to ACL constraints, matching path parameters are not required.</p>
 <p>The value for these path parameters MUST NOT contain any unescaped “generic syntax” characters described by [[!RFC3986]]: forward slashes (<code>/</code>), question marks (<code>?</code>), or hashes (<code>#</code>).</p>
-</section><section><h4><span id="mediaTypes"><dfn>Media Types</dfn></span></h4>
+<p><a id="mediaTypes"></a></section><section><h4><span><dfn>Media Types</dfn></span></h4></p>
 <p>Media type definitions are spread across several resources.
 The media type definitions SHOULD be in compliance with [[!RFC6838]].</p>
 <p>Some examples of possible media type definitions:</p>
@@ -38,7 +38,7 @@
   application/vnd.github.v3.diff
   application/vnd.github.v3.patch
 </code></pre>
-</section><section><h4><span id="httpCodes"><dfn>HTTP Status Codes</dfn></span></h4>
+<p><a id="httpCodes"></a></section><section><h4><span><dfn>HTTP Status Codes</dfn></span></h4></p>
 <p>The HTTP Status Codes are used to indicate the status of the executed operation.
 The available status codes are defined by [[!RFC7231]] and registered status codes are listed in the <a href="https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml">IANA Status Code Registry</a>.</p>
 </section></section></section></section><section><h1>Specification</h1>
@@ -50,9 +50,9 @@
 <p>An OpenAPI document that conforms to the OpenAPI Specification is itself a JSON object, which may be represented either in JSON or YAML format.</p>
 <p>For example, if a field has an array value, the JSON array representation will be used:</p>
 <pre class="nohighlight"><code>
-{
-   <span class="hljs-attr">&quot;field&quot;</span>: [ <span class="hljs-number">1</span>, <span class="hljs-number">2</span>, <span class="hljs-number">3</span> ]
-}
+<span class="hljs-punctuation">{</span>
+   <span class="hljs-attr">&quot;field&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span> <span class="hljs-number">1</span><span class="hljs-punctuation">,</span> <span class="hljs-number">2</span><span class="hljs-punctuation">,</span> <span class="hljs-number">3</span> <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>All field names in the specification are <strong>case sensitive</strong>.
 This includes all fields that are used as keys in a map, except where explicitly noted that keys are <strong>case insensitive</strong>.</p>
@@ -64,10 +64,10 @@
 <li>Keys used in YAML maps MUST be limited to a scalar string, as defined by the <a href="https://yaml.org/spec/1.2/spec.html#id2802346">YAML Failsafe schema ruleset</a>.</li>
 </ul>
 <p><strong>Note:</strong> While APIs may be defined by OpenAPI documents in either YAML or JSON format, the API request and response bodies and other content are not required to be JSON or YAML.</p>
-</section><section><h2><span id="documentStructure">Document Structure</span></h2>
+<p><a id="documentStructure"></a></section><section><h2><span>Document Structure</span></h2></p>
 <p>An OpenAPI document MAY be made up of a single document or be divided into multiple, connected parts at the discretion of the author. In the latter case, <a href="#referenceObject"><code>Reference Objects</code></a> and <a href="#schemaObject"><code>Schema Object</code></a> <code>$ref</code> keywords are used.</p>
 <p>It is RECOMMENDED that the root OpenAPI document be named: <code>openapi.json</code> or <code>openapi.yaml</code>.</p>
-</section><section><h2><span id="dataTypes">Data Types</span></h2>
+<p><a id="dataTypes"></a></section><section><h2><span>Data Types</span></h2></p>
 <p>Data types in the OAS are based on the types supported by the <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00#section-4.2.1">JSON Schema Specification Draft 2020-12</a>.
 Note that <code>integer</code> as a type is also supported and is defined as a JSON number without a fraction or exponent part.
 Models are defined using the <a href="#schemaObject">Schema Object</a>, which is a superset of JSON Schema Specification Draft 2020-12.</p>
@@ -110,20 +110,20 @@
 </tr>
 </tbody>
 </table>
-</section><section><h2><span id="richText">Rich Text Formatting</span></h2>
+<p><a id="richText"></a></section><section><h2><span>Rich Text Formatting</span></h2></p>
 <p>Throughout the specification <code>description</code> fields are noted as supporting CommonMark markdown formatting.
 Where OpenAPI tooling renders rich text it MUST support, at a minimum, markdown syntax as described by <a href="https://spec.commonmark.org/0.27/">CommonMark 0.27</a>. Tooling MAY choose to ignore some CommonMark features to address security concerns.</p>
-</section><section><h2><span id="relativeReferencesURI">Relative References in URIs</span></h2>
+<p><a id="relativeReferencesURI"></a></section><section><h2><span>Relative References in URIs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URIs MAY be relative references as defined by [[!RFC3986]].</p>
 <p>Relative references, including those in <a href="#referenceObject"><code>Reference Objects</code></a>, <a href="#pathItemObject"><code>PathItem Object</code></a> <code>$ref</code> fields, <a href="#linkObject"><code>Link Object</code></a> <code>operationRef</code> fields and <a href="#exampleObject"><code>Example Object</code></a> <code>externalValue</code> fields, are resolved using the referring document as the Base URI according to [[!RFC3986]].</p>
 <p>If a URI contains a fragment identifier, then the fragment should be resolved per the fragment resolution mechanism of the referenced document.  If the representation of the referenced document is JSON or YAML, then the fragment identifier SHOULD be interpreted as a JSON-Pointer as per [[!RFC6901]].</p>
 <p>Relative references in <a href="#schemaObject"><code>Schema Objects</code></a>, including any that appear as <code>$id</code> values, use the nearest parent <code>$id</code> as a Base URI, as described by <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00#section-8.2">JSON Schema Specification Draft 2020-12</a>.  If no parent schema contains an <code>$id</code>, then the Base URI MUST be determined according to [[!RFC3986]].</p>
-</section><section><h2><span id="relativeReferencesURL">Relative References in URLs</span></h2>
+<p><a id="relativeReferencesURL"></a></section><section><h2><span>Relative References in URLs</span></h2></p>
 <p>Unless specified otherwise, all properties that are URLs MAY be relative references as defined by [[!RFC3986]].
 Unless specified otherwise, relative references are resolved using the URLs defined in the <a href="#serverObject"><code>Server Object</code></a> as a Base URL. Note that these themselves MAY be relative to the referring document.</p>
 </section><section><h2>Schema</h2>
 <p>In the following description, if a field is not explicitly <strong>REQUIRED</strong> or described with a MUST or SHALL, it can be considered OPTIONAL.</p>
-<section><h3><span id="oasObject">OpenAPI Object</span></h3>
+<p><a id="oasObject"></a><section><h3><span>OpenAPI Object</span></h3></p>
 <p>This is the root object of the <a href="#oasDocument">OpenAPI document</a>.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -188,7 +188,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="infoObject">Info Object</span></h3>
+<p><a id="infoObject"></a></section></section><section><h3><span>Info Object</span></h3></p>
 <p>The object provides metadata about the API.
 The metadata MAY be used by the clients if needed, and MAY be presented in editing or documentation generation tools for convenience.</p>
 <section><h4>Fixed Fields</h4>
@@ -241,22 +241,22 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Info Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;title&quot;</span>: <span class="hljs-string">&quot;Sample Pet Store App&quot;</span>,
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;A pet store manager.&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span>,
-  <span class="hljs-attr">&quot;termsOfService&quot;</span>: <span class="hljs-string">&quot;https://example.com/terms/&quot;</span>,
-  <span class="hljs-attr">&quot;contact&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.example.com/support&quot;</span>,
-    <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-  },
-  <span class="hljs-attr">&quot;license&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-    <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
-  },
-  <span class="hljs-attr">&quot;version&quot;</span>: <span class="hljs-string">&quot;1.0.1&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;title&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Sample Pet Store App&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A pet store manager.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;This is a sample server for a pet store.&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;termsOfService&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/terms/&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;contact&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;license&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.apache.org/licenses/LICENSE-2.0.html&quot;</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;version&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;1.0.1&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">title:</span> <span class="hljs-string">Sample</span> <span class="hljs-string">Pet</span> <span class="hljs-string">Store</span> <span class="hljs-string">App</span>
@@ -272,7 +272,7 @@
   <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.apache.org/licenses/LICENSE-2.0.html</span>
 <span class="hljs-attr">version:</span> <span class="hljs-number">1.0</span><span class="hljs-number">.1</span>
 </code></pre>
-</section></section><section><h3><span id="contactObject">Contact Object</span></h3>
+<p><a id="contactObject"></a></section></section><section><h3><span>Contact Object</span></h3></p>
 <p>Contact information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -304,18 +304,18 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Contact Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;API Support&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://www.example.com/support&quot;</span>,
-  <span class="hljs-attr">&quot;email&quot;</span>: <span class="hljs-string">&quot;support@example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;API Support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://www.example.com/support&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;email&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;support@example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">API</span> <span class="hljs-string">Support</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://www.example.com/support</span>
 <span class="hljs-attr">email:</span> <span class="hljs-string">support@example.com</span>
 </code></pre>
-</section></section><section><h3><span id="licenseObject">License Object</span></h3>
+<p><a id="licenseObject"></a></section></section><section><h3><span>License Object</span></h3></p>
 <p>License information for the exposed API.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -335,7 +335,7 @@
 <tr>
 <td><a id="licenseIdentifier"> </a>identifier</td>
 <td style="text-align:center"><code>string</code></td>
-<td>An <a href="https://spdx.org/spdx-specification-21-web-version#h.jxpfx0ykyb60">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field.</td>
+<td>An <a href="https://spdx.org/licenses/">SPDX</a> license expression for the API. The <code>identifier</code> field is mutually exclusive of the <code>url</code> field.</td>
 </tr>
 <tr>
 <td><a id="licenseUrl"> </a>url</td>
@@ -347,16 +347,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>License Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Apache 2.0&quot;</span>,
-  <span class="hljs-attr">&quot;identifier&quot;</span>: <span class="hljs-string">&quot;Apache-2.0&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache 2.0&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;identifier&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Apache-2.0&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">Apache</span> <span class="hljs-number">2.0</span>
 <span class="hljs-attr">identifier:</span> <span class="hljs-string">Apache-2.0</span>
 </code></pre>
-</section></section><section><h3><span id="serverObject">Server Object</span></h3>
+<p><a id="serverObject"></a></section></section><section><h3><span>Server Object</span></h3></p>
 <p>An object representing a Server.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -389,10 +389,10 @@
 </section><section><h4>Server Object Example</h4>
 <p>A single server would be described as:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://development.gigantic-server.com/v1</span>
@@ -400,22 +400,22 @@
 </code></pre>
 <p>The following shows how multiple servers can be described, for example, at the OpenAPI Object’s <a href="#oasServers"><code>servers</code></a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Development server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Staging server&quot;</span>
-    },
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Production server&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://development.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Development server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://staging.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Staging server&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://api.gigantic-server.com/v1&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Production server&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -428,30 +428,30 @@
 </code></pre>
 <p>The following shows how variables can be used for a server configuration:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;servers&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The production API server&quot;</span>,
-      <span class="hljs-attr">&quot;variables&quot;</span>: {
-        <span class="hljs-attr">&quot;username&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;demo&quot;</span>,
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
-        },
-        <span class="hljs-attr">&quot;port&quot;</span>: {
-          <span class="hljs-attr">&quot;enum&quot;</span>: [
-            <span class="hljs-string">&quot;8443&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;servers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://{username}.gigantic-server.com:{port}/{basePath}&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The production API server&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;variables&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;username&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;demo&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;this value is assigned by the service provider, in this example `gigantic-server.com`&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;port&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+            <span class="hljs-string">&quot;8443&quot;</span><span class="hljs-punctuation">,</span>
             <span class="hljs-string">&quot;443&quot;</span>
-          ],
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;8443&quot;</span>
-        },
-        <span class="hljs-attr">&quot;basePath&quot;</span>: {
-          <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;v2&quot;</span>
-        }
-      }
-    }
-  ]
-}
+          <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;8443&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;basePath&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;v2&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">servers:</span>
@@ -471,7 +471,7 @@
       <span class="hljs-comment"># open meaning there is the opportunity to use special base paths as assigned by the provider, default is `v2`</span>
       <span class="hljs-attr">default:</span> <span class="hljs-string">v2</span>
 </code></pre>
-</section></section><section><h3><span id="serverVariableObject">Server Variable Object</span></h3>
+<p><a id="serverVariableObject"></a></section></section><section><h3><span>Server Variable Object</span></h3></p>
 <p>An object representing a Server Variable for server URL template substitution.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -501,7 +501,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="componentsObject">Components Object</span></h3>
+<p><a id="componentsObject"></a></section></section><section><h3><span>Components Object</span></h3></p>
 <p>Holds a set of reusable objects for different aspects of the OAS.
 All objects defined within the components object will have no effect on the API unless they are explicitly referenced from properties outside the components object.</p>
 <section><h4>Fixed Fields</h4>
@@ -578,105 +578,105 @@
 </code></pre>
 </section><section><h4>Components Object Example</h4>
 <pre class="nohighlight"><code>
-&quot;components&quot;: {
-  &quot;schemas&quot;: {
-    &quot;GeneralError&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;code&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int32&quot;
-        },
-        &quot;message&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Category&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    },
-    &quot;Tag&quot;: {
-      &quot;type&quot;: &quot;object&quot;,
-      &quot;properties&quot;: {
-        &quot;id&quot;: {
-          &quot;type&quot;: &quot;integer&quot;,
-          &quot;format&quot;: &quot;int64&quot;
-        },
-        &quot;name&quot;: {
-          &quot;type&quot;: &quot;string&quot;
-        }
-      }
-    }
-  },
-  &quot;parameters&quot;: {
-    &quot;skipParam&quot;: {
-      &quot;name&quot;: &quot;skip&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;number of items to skip&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot;: {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    },
-    &quot;limitParam&quot;: {
-      &quot;name&quot;: &quot;limit&quot;,
-      &quot;in&quot;: &quot;query&quot;,
-      &quot;description&quot;: &quot;max records to return&quot;,
-      &quot;required&quot;: true,
-      &quot;schema&quot; : {
-        &quot;type&quot;: &quot;integer&quot;,
-        &quot;format&quot;: &quot;int32&quot;
-      }
-    }
-  },
-  &quot;responses&quot;: {
-    &quot;NotFound&quot;: {
-      &quot;description&quot;: &quot;Entity not found.&quot;
-    },
-    &quot;IllegalInput&quot;: {
-      &quot;description&quot;: &quot;Illegal input for operation.&quot;
-    },
-    &quot;GeneralError&quot;: {
-      &quot;description&quot;: &quot;General Error&quot;,
-      &quot;content&quot;: {
-        &quot;application/json&quot;: {
-          &quot;schema&quot;: {
-            &quot;$ref&quot;: &quot;#/components/schemas/GeneralError&quot;
-          }
-        }
-      }
-    }
-  },
-  &quot;securitySchemes&quot;: {
-    &quot;api_key&quot;: {
-      &quot;type&quot;: &quot;apiKey&quot;,
-      &quot;name&quot;: &quot;api_key&quot;,
-      &quot;in&quot;: &quot;header&quot;
-    },
-    &quot;petstore_auth&quot;: {
-      &quot;type&quot;: &quot;oauth2&quot;,
-      &quot;flows&quot;: {
-        &quot;implicit&quot;: {
-          &quot;authorizationUrl&quot;: &quot;https://example.org/api/oauth/dialog&quot;,
-          &quot;scopes&quot;: {
-            &quot;write:pets&quot;: &quot;modify pets in your account&quot;,
-            &quot;read:pets&quot;: &quot;read your pets&quot;
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Category&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;Tag&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;skipParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number of items to skip&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;limitParam&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;limit&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;max records to return&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;NotFound&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Entity not found.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;IllegalInput&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Illegal input for operation.&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;GeneralError&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;General Error&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/GeneralError&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;securitySchemes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.org/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -747,7 +747,7 @@
             <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
             <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section><section><h3><span id="pathsObject">Paths Object</span></h3>
+<p><a id="pathsObject"></a></section></section><section><h3><span>Paths Object</span></h3></p>
 <p>Holds the relative paths to the individual endpoints and their operations.
 The path is appended to the URL from the <a href="#serverObject"><code>Server Object</code></a> in order to construct the full URL.  The Paths MAY be empty, due to <a href="#securityFiltering">Access Control List (ACL) constraints</a>.</p>
 <section><h4>Patterned Fields</h4>
@@ -786,28 +786,28 @@
 </code></pre>
 </section><section><h4>Paths Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;/pets&quot;</span>: {
-    <span class="hljs-attr">&quot;get&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span>,
-      <span class="hljs-attr">&quot;responses&quot;</span>: {
-        <span class="hljs-attr">&quot;200&quot;</span>: {          
-          <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A list of pets.&quot;</span>,
-          <span class="hljs-attr">&quot;content&quot;</span>: {
-            <span class="hljs-attr">&quot;application/json&quot;</span>: {
-              <span class="hljs-attr">&quot;schema&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-                <span class="hljs-attr">&quot;items&quot;</span>: {
-                  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;/pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns all pets from the system that the user has access to&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>          
+          <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A list of pets.&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/pet&quot;</span>
+                <span class="hljs-punctuation">}</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">/pets:</span>
@@ -823,7 +823,7 @@
               <span class="hljs-attr">items:</span>
                 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/pet&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="pathItemObject">Path Item Object</span></h3>
+<p><a id="pathItemObject"></a></section></section><section><h3><span>Path Item Object</span></h3></p>
 <p>Describes the operations available on a single path.
 A Path Item MAY be empty, due to <a href="#securityFiltering">ACL constraints</a>.
 The path itself is still exposed to the documentation viewer but they will not know which operations and parameters are available.</p>
@@ -907,53 +907,53 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Path Item Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;get&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Returns pets based on ID&quot;</span>,
-    <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Find pets by ID&quot;</span>,
-    <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;getPetsById&quot;</span>,
-    <span class="hljs-attr">&quot;responses&quot;</span>: {
-      <span class="hljs-attr">&quot;200&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;pet response&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;*/*&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-              <span class="hljs-attr">&quot;items&quot;</span>: {
-                <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-              }
-            }
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;default&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;error payload&quot;</span>,
-        <span class="hljs-attr">&quot;content&quot;</span>: {
-          <span class="hljs-attr">&quot;text/html&quot;</span>: {
-            <span class="hljs-attr">&quot;schema&quot;</span>: {
-              <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-            }
-          }
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet to use&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      },
-      <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-    }
-  ]
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;get&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Returns pets based on ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find pets by ID&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;getPetsById&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet response&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;error payload&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;text/html&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet to use&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">get:</span>
@@ -986,7 +986,7 @@
       <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>  
   <span class="hljs-attr">style:</span> <span class="hljs-string">simple</span>
 </code></pre>
-</section></section><section><h3><span id="operationObject">Operation Object</span></h3>
+<p><a id="operationObject"></a></section></section><section><h3><span>Operation Object</span></h3></p>
 <p>Describes a single API operation on a path.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1031,7 +1031,7 @@
 <tr>
 <td><a id="operationRequestBody"> </a>requestBody</td>
 <td style="text-align:center"><a href="#requestBodyObject">Request Body Object</a> | <a href="#referenceObject">Reference Object</a></td>
-<td>The request body applicable for this operation.  The <code>requestBody</code> is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague (such as [GET]section-4.3.1), [HEAD]section-4.3.2) and [DELETE]section-4.3.5)), <code>requestBody</code> is permitted but does not have well-defined semantics and SHOULD be avoided if possible.</td>
+<td>The request body applicable for this operation.  The <code>requestBody</code> is fully supported in HTTP methods where the HTTP 1.1 specification [[!RFC7231]] has explicitly defined semantics for request bodies.  In other cases where the HTTP spec is vague (such as <a href="https://tools.ietf.org/html/rfc7231#section-4.3.1">GET</a>, <a href="https://tools.ietf.org/html/rfc7231#section-4.3.2">HEAD</a> and <a href="https://tools.ietf.org/html/rfc7231#section-4.3.5">DELETE</a>), <code>requestBody</code> is permitted but does not have well-defined semantics and SHOULD be avoided if possible.</td>
 </tr>
 <tr>
 <td><a id="operationResponses"> </a>responses</td>
@@ -1063,68 +1063,68 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Operation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;tags&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;tags&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;pet&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span>,
-  <span class="hljs-attr">&quot;operationId&quot;</span>: <span class="hljs-string">&quot;updatePetWithForm&quot;</span>,
-  <span class="hljs-attr">&quot;parameters&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;petId&quot;</span>,
-      <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span>,
-      <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  ],
-  <span class="hljs-attr">&quot;requestBody&quot;</span>: {
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-          <span class="hljs-attr">&quot;properties&quot;</span>: {
-            <span class="hljs-attr">&quot;name&quot;</span>: { 
-              <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated name of the pet&quot;</span>,
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-            },
-            <span class="hljs-attr">&quot;status&quot;</span>: {
-              <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Updated status of the pet&quot;</span>,
-              <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-            }
-          },
-          <span class="hljs-attr">&quot;required&quot;</span>: [<span class="hljs-string">&quot;status&quot;</span>] 
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;responses&quot;</span>: {
-    <span class="hljs-attr">&quot;200&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pet updated.&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    },
-    <span class="hljs-attr">&quot;405&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Method Not Allowed&quot;</span>,
-      <span class="hljs-attr">&quot;content&quot;</span>: {
-        <span class="hljs-attr">&quot;application/json&quot;</span>: {},
-        <span class="hljs-attr">&quot;application/xml&quot;</span>: {}
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updates a pet in the store with form data&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;operationId&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;updatePetWithForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;parameters&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petId&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of pet that needs to be updated&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;requestBody&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/x-www-form-urlencoded&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span> 
+              <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated name of the pet&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;status&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Updated status of the pet&quot;</span><span class="hljs-punctuation">,</span>
+              <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-string">&quot;status&quot;</span><span class="hljs-punctuation">]</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;responses&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet updated.&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;405&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Method Not Allowed&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">tags:</span>
@@ -1168,7 +1168,7 @@
   <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
   <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section><section><h3><span id="externalDocumentationObject">External Documentation Object</span></h3>
+<p><a id="externalDocumentationObject"></a></section></section><section><h3><span>External Documentation Object</span></h3></p>
 <p>Allows referencing an external resource for extended documentation.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1195,16 +1195,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>External Documentation Object Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Find more info here&quot;</span>,
-  <span class="hljs-attr">&quot;url&quot;</span>: <span class="hljs-string">&quot;https://example.com&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Find more info here&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;url&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Find</span> <span class="hljs-string">more</span> <span class="hljs-string">info</span> <span class="hljs-string">here</span>
 <span class="hljs-attr">url:</span> <span class="hljs-string">https://example.com</span>
 </code></pre>
-</section></section><section><h3><span id="parameterObject">Parameter Object</span></h3>
+<p><a id="parameterObject"></a></section></section><section><h3><span>Parameter Object</span></h3></p>
 <p>Describes a single operation parameter.</p>
 <p>A unique parameter is defined by a combination of a <a href="#parameterName">name</a> and <a href="#parameterIn">location</a>.</p>
 <section><h4>Parameter Locations</h4>
@@ -1319,7 +1319,7 @@
 </tr>
 </tbody>
 </table>
-</section><section><h4><span id="styleValues">Style Values</span></h4>
+<p><a id="styleValues"></a></section><section><h4><span>Style Values</span></h4></p>
 <p>In order to support common ways of serializing simple parameters, a set of <code>style</code> values are defined.</p>
 <table>
 <thead>
@@ -1489,20 +1489,20 @@
 </section><section><h4>Parameter Object Examples</h4>
 <p>A header parameter with an array of 64 bit integer numbers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;token&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;token to be passed as a header&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;simple&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;token to be passed as a header&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;simple&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">token</span>
@@ -1518,15 +1518,15 @@
 </code></pre>
 <p>A path parameter of a string value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;username&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;path&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;username to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;path&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;username to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">username</span>
@@ -1538,20 +1538,20 @@
 </code></pre>
 <p>An optional query parameter of a string value, allowing multiple values by repeating the query parameter:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;id&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;ID of the object to fetch&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">false</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>,
-  <span class="hljs-attr">&quot;explode&quot;</span>: <span class="hljs-literal">true</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;id&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;ID of the object to fetch&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">false</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;explode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">id</span>
@@ -1567,17 +1567,17 @@
 </code></pre>
 <p>A free-form query parameter, allowing undefined parameters of a specific type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;freeForm&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-    },
-  },
-  <span class="hljs-attr">&quot;style&quot;</span>: <span class="hljs-string">&quot;form&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;freeForm&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;style&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;form&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1590,29 +1590,29 @@
 </code></pre>
 <p>A complex parameter using <code>content</code> to define serialization:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;query&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;coordinates&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;lat&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;query&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;coordinates&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;lat&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;long&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;lat&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          },
-          <span class="hljs-attr">&quot;long&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;number&quot;</span>
-          }
-        }
-      }
-    }
-  }
-}
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;lat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;long&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;number&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">in:</span> <span class="hljs-string">query</span>
@@ -1630,7 +1630,7 @@
         <span class="hljs-attr">long:</span>
           <span class="hljs-attr">type:</span> <span class="hljs-string">number</span>
 </code></pre>
-</section></section><section><h3><span id="requestBodyObject">Request Body Object</span></h3>
+<p><a id="requestBodyObject"></a></section></section><section><h3><span>Request Body Object</span></h3></p>
 <p>Describes a single request body.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1650,7 +1650,7 @@
 <tr>
 <td><a id="requestBodyContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or [media type range]appendix-D) and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td><strong>REQUIRED</strong>. The content of the request body. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For requests that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="requestBodyRequired"> </a>required</td>
@@ -1663,49 +1663,49 @@
 </section><section><h4>Request Body Examples</h4>
 <p>A request body with a referenced model definition.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User Example&quot;</span>, 
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.json&quot;</span>
-          } 
-        }
-    },
-    <span class="hljs-attr">&quot;application/xml&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
-      },
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-          <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in XML&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.xml&quot;</span>
-          }
-        }
-    },
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in Plain text&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.txt&quot;</span> 
-        }
-      } 
-    },
-    <span class="hljs-attr">&quot;*/*&quot;</span>: {
-      <span class="hljs-attr">&quot;examples&quot;</span>: {
-        <span class="hljs-attr">&quot;user&quot;</span> : {
-            <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;User example in other format&quot;</span>,
-            <span class="hljs-attr">&quot;externalValue&quot;</span>: <span class="hljs-string">&quot;https://foo.bar/examples/user-example.whatever&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User Example&quot;</span><span class="hljs-punctuation">,</span> 
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.json&quot;</span>
+          <span class="hljs-punctuation">}</span> 
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;application/xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/User&quot;</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in XML&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.xml&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in Plain text&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.txt&quot;</span> 
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span> 
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;*/*&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;user&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;User example in other format&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;externalValue&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://foo.bar/examples/user-example.whatever&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1737,20 +1737,20 @@
 </code></pre>
 <p>A body parameter that is an array of string values:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;user to add to the system&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: <span class="hljs-literal">true</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;user to add to the system&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">user</span> <span class="hljs-string">to</span> <span class="hljs-string">add</span> <span class="hljs-string">to</span> <span class="hljs-string">the</span> <span class="hljs-string">system</span>
@@ -1762,7 +1762,7 @@
       <span class="hljs-attr">items:</span>
         <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
 </code></pre>
-</section></section><section><h3><span id="mediaTypeObject">Media Type Object</span></h3>
+<p><a id="mediaTypeObject"></a></section></section><section><h3><span>Media Type Object</span></h3></p>
 <p>Each Media Type Object provides schema and examples for the media type identified by its key.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -1799,39 +1799,39 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Media Type Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;application/json&quot;</span>: {
-    <span class="hljs-attr">&quot;schema&quot;</span>: {
-         <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-    },
-    <span class="hljs-attr">&quot;examples&quot;</span>: {
-      <span class="hljs-attr">&quot;cat&quot;</span> : {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a cat&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span>: 
-          {
-            <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Fluffy&quot;</span>,
-            <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-            <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;White&quot;</span>,
-            <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;male&quot;</span>,
-            <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Persian&quot;</span>
-          }
-      },
-      <span class="hljs-attr">&quot;dog&quot;</span>: {
-        <span class="hljs-attr">&quot;summary&quot;</span>: <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span>,
-        <span class="hljs-attr">&quot;value&quot;</span> :  { 
-          <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-          <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Dog&quot;</span>,
-          <span class="hljs-attr">&quot;color&quot;</span>: <span class="hljs-string">&quot;Black&quot;</span>,
-          <span class="hljs-attr">&quot;gender&quot;</span>: <span class="hljs-string">&quot;Female&quot;</span>,
-          <span class="hljs-attr">&quot;breed&quot;</span>: <span class="hljs-string">&quot;Mixed&quot;</span>
-        },
-      <span class="hljs-attr">&quot;frog&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+         <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;examples&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;cat&quot;</span> <span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a cat&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span><span class="hljs-punctuation">:</span> 
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Fluffy&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;White&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;male&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Persian&quot;</span>
+          <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;summary&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;An example of a dog with a cat&#x27;s name&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;value&quot;</span> <span class="hljs-punctuation">:</span>  <span class="hljs-punctuation">{</span> 
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Dog&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;color&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Black&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;gender&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Female&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;breed&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Mixed&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;frog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/examples/frog-example&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">application/json:</span> 
@@ -1975,7 +1975,7 @@
               <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Address&#x27;</span>
 </code></pre>
 <p>An <code>encoding</code> attribute is introduced to give you control over the serialization of parts of <code>multipart</code> request bodies.  This attribute is <em>only</em> applicable to <code>multipart</code> and <code>application/x-www-form-urlencoded</code> request bodies.</p>
-</section></section><section><h3><span id="encodingObject">Encoding Object</span></h3>
+<p><a id="encodingObject"></a></section></section><section><h3><span>Encoding Object</span></h3></p>
 <p>A single encoding definition applied to a single schema property.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -2050,7 +2050,7 @@
               <span class="hljs-attr">schema:</span>
                 <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="responsesObject">Responses Object</span></h3>
+<p><a id="responsesObject"></a></section></section><section><h3><span>Responses Object</span></h3></p>
 <p>A container for the expected responses of an operation.
 The container maps a HTTP response code to the expected response.</p>
 <p>The documentation is not necessarily expected to cover all possible HTTP response codes because they may not be known in advance.
@@ -2098,28 +2098,28 @@
 </section><section><h4>Responses Object Example</h4>
 <p>A 200 response for a successful operation and a default response for others (implying an error):</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;200&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;a pet to be returned&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-        }
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;default&quot;</span>: {
-    <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Unexpected error&quot;</span>,
-    <span class="hljs-attr">&quot;content&quot;</span>: {
-      <span class="hljs-attr">&quot;application/json&quot;</span>: {
-        <span class="hljs-attr">&quot;schema&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;200&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;a pet to be returned&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Unexpected error&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">&#x27;200&#x27;:</span>
@@ -2135,7 +2135,7 @@
       <span class="hljs-attr">schema:</span>
         <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/ErrorModel&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="responseObject">Response Object</span></h3>
+<p><a id="responseObject"></a></section></section><section><h3><span>Response Object</span></h3></p>
 <p>Describes a single response from an API Operation, including design-time, static
 <code>links</code> to operations based on the response.</p>
 <section><h4>Fixed Fields</h4>
@@ -2161,7 +2161,7 @@
 <tr>
 <td><a id="responseContent"> </a>content</td>
 <td style="text-align:center">Map[<code>string</code>, <a href="#mediaTypeObject">Media Type Object</a>]</td>
-<td>A map containing descriptions of potential response payloads. The key is a media type or [media type range]appendix-D) and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
+<td>A map containing descriptions of potential response payloads. The key is a media type or <a href="https://tools.ietf.org/html/rfc7231#appendix-D">media type range</a> and the value describes it.  For responses that match multiple keys, only the most specific key is applicable. e.g. text/plain overrides text/*</td>
 </tr>
 <tr>
 <td><a id="responseLinks"> </a>links</td>
@@ -2174,19 +2174,19 @@
 </section><section><h4>Response Object Examples</h4>
 <p>Response of an array of a complex type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A complex object array response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;application/json&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-          <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A complex object array response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;application/json&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/VeryComplexType&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">complex</span> <span class="hljs-string">object</span> <span class="hljs-string">array</span> <span class="hljs-string">response</span>
@@ -2199,17 +2199,17 @@
 </code></pre>
 <p>Response with a string type:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-      }
-    }
-  }
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
 
-}
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2220,37 +2220,37 @@
 </code></pre>
 <p>Plain text response with headers:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A simple string response&quot;</span>,
-  <span class="hljs-attr">&quot;content&quot;</span>: {
-    <span class="hljs-attr">&quot;text/plain&quot;</span>: {
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;example&quot;</span>: <span class="hljs-string">&quot;whoa!&quot;</span>
-      }
-    }
-  },
-  <span class="hljs-attr">&quot;headers&quot;</span>: {
-    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span>: {
-      <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span>,
-      <span class="hljs-attr">&quot;schema&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A simple string response&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;content&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;text/plain&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;whoa!&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;headers&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Limit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Remaining&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of remaining requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;X-Rate-Limit-Reset&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of seconds left in the current period&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">A</span> <span class="hljs-string">simple</span> <span class="hljs-string">string</span> <span class="hljs-string">response</span>
@@ -2275,14 +2275,14 @@
 </code></pre>
 <p>Response with no return value:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;object created&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object created&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">object</span> <span class="hljs-string">created</span>
 </code></pre>
-</section></section><section><h3><span id="callbackObject">Callback Object</span></h3>
+<p><a id="callbackObject"></a></section></section><section><h3><span>Callback Object</span></h3></p>
 <p>A map of possible out-of band callbacks related to the parent operation.
 Each value in the map is a <a href="#pathItemObject">Path Item Object</a> that describes a set of requests that may be initiated by the API provider and the expected responses.
 The key value used to identify the path item object is an expression, evaluated at runtime, that identifies a URL to use for the callback operation.</p>
@@ -2317,7 +2317,7 @@
 <span class="hljs-attribute">Content-Type</span><span class="hljs-punctuation">: </span>application/json
 <span class="hljs-attribute">Content-Length</span><span class="hljs-punctuation">: </span>187
 
-<span class="awk">{
+<span class="language-avrasm">{
   <span class="hljs-string">&quot;failedUrl&quot;</span> : <span class="hljs-string">&quot;https://clientdomain.com/failed&quot;</span>,
   <span class="hljs-string">&quot;successUrls&quot;</span> : [
     <span class="hljs-string">&quot;https://clientdomain.com/fast&quot;</span>,
@@ -2327,7 +2327,7 @@
 }
 
 <span class="hljs-number">201</span> Created
-Location: https:<span class="hljs-regexp">//</span>example.org<span class="hljs-regexp">/subscription/</span><span class="hljs-number">1</span>
+<span class="hljs-symbol">Location:</span> https://example<span class="hljs-meta">.org</span>/subscription/<span class="hljs-number">1</span>
 </span></code></pre>
 <p>The following examples show how the various expressions evaluate, assuming the callback operation has a path parameter named <code>eventType</code> and a query parameter named <code>queryUrl</code>.</p>
 <table>
@@ -2403,7 +2403,7 @@
         <span class="hljs-attr">&#x27;200&#x27;:</span>
           <span class="hljs-attr">description:</span> <span class="hljs-string">callback</span> <span class="hljs-string">successfully</span> <span class="hljs-string">processed</span>
 </code></pre>
-</section></section><section><h3><span id="exampleObject">Example Object</span></h3>
+<p><a id="exampleObject"></a></section></section><section><h3><span>Example Object</span></h3></p>
 <section><h4>Fixed Fields</h4>
 <table>
 <thead>
@@ -2491,7 +2491,7 @@
           <span class="hljs-attr">confirmation-success:</span>
             <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/examples/confirmation-success&#x27;</span>
 </code></pre>
-</section></section><section><h3><span id="linkObject">Link Object</span></h3>
+<p><a id="linkObject"></a></section></section><section><h3><span>Link Object</span></h3></p>
 <p>The <code>Link object</code> represents a possible design-time link for a response.
 The presence of a link does not guarantee the caller’s ability to successfully invoke it, rather it provides a known relationship and traversal mechanism between responses and other operations.</p>
 <p>Unlike <em>dynamic</em> links (i.e. links provided <strong>in</strong> the response payload), the OAS linking mechanism does not require link information in the runtime response.</p>
@@ -2625,32 +2625,32 @@
 </code></pre>
 <p>Note that in the use of <code>operationRef</code>, the <em>escaped forward-slash</em> is necessary when
 using JSON references.</p>
-</section><section><h4><span id="runtimeExpression">Runtime Expressions</span></h4>
+<p><a id="runtimeExpression"></a></section><section><h4><span>Runtime Expressions</span></h4></p>
 <p>Runtime expressions allow defining values based on information that will only be available within the HTTP message in an actual API call.
 This mechanism is used by <a href="#linkObject">Link Objects</a> and <a href="#callbackObject">Callback Objects</a>.</p>
-<p>The runtime expression is defined by the following [ABNF] syntax</p>
-<pre class="nohighlight"><code>
-      expression = ( <span class="hljs-string">&quot;$url&quot;</span> / <span class="hljs-string">&quot;$method&quot;</span> / <span class="hljs-string">&quot;$statusCode&quot;</span> / <span class="hljs-string">&quot;$request.&quot;</span> source / <span class="hljs-string">&quot;$response.&quot;</span> source )
-      source = ( header-reference / query-reference / path-reference / body-reference )
-      header-reference = <span class="hljs-string">&quot;header.&quot;</span> token
-      query-reference = <span class="hljs-string">&quot;query.&quot;</span> name  
-      path-reference = <span class="hljs-string">&quot;path.&quot;</span> name
-      body-reference = <span class="hljs-string">&quot;body&quot;</span> [<span class="hljs-string">&quot;#&quot;</span> json-pointer ]
-      json-pointer    = *( <span class="hljs-string">&quot;/&quot;</span> reference-token )
-      reference-token = *( unescaped / escaped )
-      unescaped       = <span class="hljs-symbol">%x00-2E</span> / <span class="hljs-symbol">%x30-7D</span> / <span class="hljs-symbol">%x7F-10FFFF</span>
+<p>The runtime expression is defined by the following <a href="https://tools.ietf.org/html/rfc5234">ABNF</a> syntax</p>
+<pre class="nohighlight"><code>
+      expression <span class="hljs-operator">=</span> ( <span class="hljs-string">&quot;$url&quot;</span> / <span class="hljs-string">&quot;$method&quot;</span> / <span class="hljs-string">&quot;$statusCode&quot;</span> / <span class="hljs-string">&quot;$request.&quot;</span> source / <span class="hljs-string">&quot;$response.&quot;</span> source )
+      source <span class="hljs-operator">=</span> ( header-reference / query-reference / path-reference / body-reference )
+      header-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;header.&quot;</span> token
+      query-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;query.&quot;</span> name  
+      path-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;path.&quot;</span> name
+      body-reference <span class="hljs-operator">=</span> <span class="hljs-string">&quot;body&quot;</span> [<span class="hljs-string">&quot;#&quot;</span> json-pointer ]
+      json-pointer    <span class="hljs-operator">=</span> *( <span class="hljs-string">&quot;/&quot;</span> reference-token )
+      reference-token <span class="hljs-operator">=</span> *( unescaped / escaped )
+      unescaped       <span class="hljs-operator">=</span> <span class="hljs-symbol">%x00-2E</span> / <span class="hljs-symbol">%x30-7D</span> / <span class="hljs-symbol">%x7F-10FFFF</span>
          <span class="hljs-comment">; %x2F (&#x27;/&#x27;) and %x7E (&#x27;~&#x27;) are excluded from &#x27;unescaped&#x27;</span>
-      escaped         = <span class="hljs-string">&quot;~&quot;</span> ( <span class="hljs-string">&quot;0&quot;</span> / <span class="hljs-string">&quot;1&quot;</span> )
+      escaped         <span class="hljs-operator">=</span> <span class="hljs-string">&quot;~&quot;</span> ( <span class="hljs-string">&quot;0&quot;</span> / <span class="hljs-string">&quot;1&quot;</span> )
         <span class="hljs-comment">; representing &#x27;~&#x27; and &#x27;/&#x27;, respectively</span>
-      name = *( <span class="hljs-keyword">CHAR</span> )
-      token = <span class="hljs-number">1</span>*tchar
-      tchar = <span class="hljs-string">&quot;!&quot;</span> / <span class="hljs-string">&quot;#&quot;</span> / <span class="hljs-string">&quot;$&quot;</span> / <span class="hljs-string">&quot;%&quot;</span> / <span class="hljs-string">&quot;&amp;&quot;</span> / <span class="hljs-string">&quot;&#x27;&quot;</span> / <span class="hljs-string">&quot;*&quot;</span> / <span class="hljs-string">&quot;+&quot;</span> / <span class="hljs-string">&quot;-&quot;</span> / <span class="hljs-string">&quot;.&quot;</span> /
+      name <span class="hljs-operator">=</span> *( <span class="hljs-keyword">CHAR</span> )
+      token <span class="hljs-operator">=</span> <span class="hljs-number">1</span>*tchar
+      tchar <span class="hljs-operator">=</span> <span class="hljs-string">&quot;!&quot;</span> / <span class="hljs-string">&quot;#&quot;</span> / <span class="hljs-string">&quot;$&quot;</span> / <span class="hljs-string">&quot;%&quot;</span> / <span class="hljs-string">&quot;&amp;&quot;</span> / <span class="hljs-string">&quot;&#x27;&quot;</span> / <span class="hljs-string">&quot;*&quot;</span> / <span class="hljs-string">&quot;+&quot;</span> / <span class="hljs-string">&quot;-&quot;</span> / <span class="hljs-string">&quot;.&quot;</span> /
         <span class="hljs-string">&quot;^&quot;</span> / <span class="hljs-string">&quot;_&quot;</span> / <span class="hljs-string">&quot;`&quot;</span> / <span class="hljs-string">&quot;|&quot;</span> / <span class="hljs-string">&quot;~&quot;</span> / <span class="hljs-keyword">DIGIT</span> / <span class="hljs-keyword">ALPHA</span>
 </code></pre>
 <p>Here, <code>json-pointer</code> is taken from [[!RFC6901]], <code>char</code> from [[!RFC7159]] and <code>token</code> from [[!RFC7230]].</p>
 <p>The <code>name</code> identifier is case-sensitive, whereas <code>token</code> is not.</p>
 <p>The table below provides examples of runtime expressions and examples of their use in a value:</p>
-</section><section><h4><span id="runtimeExpressionExamples">Examples</span></h4>
+<p><a id="runtimeExpressionExamples"></a></section><section><h4><span>Examples</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2699,7 +2699,7 @@
 </table>
 <p>Runtime expressions preserve the type of the referenced value.
 Expressions can be embedded into string values by surrounding the expression with <code>{}</code> curly braces.</p>
-</section></section><section><h3><span id="headerObject">Header Object</span></h3>
+<p><a id="headerObject"></a></section></section><section><h3><span>Header Object</span></h3></p>
 <p>The Header Object follows the structure of the <a href="#parameterObject">Parameter Object</a> with the following changes:</p>
 <ol>
 <li><code>name</code> MUST NOT be specified, it is given in the corresponding <code>headers</code> map.</li>
@@ -2709,19 +2709,19 @@
 <section><h4>Header Object Example</h4>
 <p>A simple header of type <code>integer</code>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span>,
-  <span class="hljs-attr">&quot;schema&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The number of allowed requests in the current period&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;schema&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">description:</span> <span class="hljs-string">The</span> <span class="hljs-string">number</span> <span class="hljs-string">of</span> <span class="hljs-string">allowed</span> <span class="hljs-string">requests</span> <span class="hljs-string">in</span> <span class="hljs-string">the</span> <span class="hljs-string">current</span> <span class="hljs-string">period</span>
 <span class="hljs-attr">schema:</span>
   <span class="hljs-attr">type:</span> <span class="hljs-string">integer</span>
 </code></pre>
-</section></section><section><h3><span id="tagObject">Tag Object</span></h3>
+<p><a id="tagObject"></a></section></section><section><h3><span>Tag Object</span></h3></p>
 <p>Adds metadata to a single tag that is used by the <a href="#operationObject">Operation Object</a>.
 It is not mandatory to have a Tag Object per tag defined in the Operation Object instances.</p>
 <section><h4>Fixed Fields</h4>
@@ -2754,16 +2754,16 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>Tag Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;pet&quot;</span>,
-	<span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;Pets operations&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;pet&quot;</span><span class="hljs-punctuation">,</span>
+	<span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pets operations&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">name:</span> <span class="hljs-string">pet</span>
 <span class="hljs-attr">description:</span> <span class="hljs-string">Pets</span> <span class="hljs-string">operations</span>
 </code></pre>
-</section></section><section><h3><span id="referenceObject">Reference Object</span></h3>
+<p><a id="referenceObject"></a></section></section><section><h3><span>Reference Object</span></h3></p>
 <p>A simple object to allow referencing other components in the OpenAPI document, internally and externally.</p>
 <p>The <code>$ref</code> string value contains a URI [[!RFC3986]], which identifies the location of the value being referenced.</p>
 <p>See the rules for resolving <a href="#relativeReferencesURI">Relative References</a>.</p>
@@ -2798,32 +2798,32 @@
 <p>Note that this restriction on additional properties is a difference between Reference Objects and <a href="#schemaObject"><code>Schema Objects</code></a> that contain a <code>$ref</code> keyword.</p>
 </section><section><h4>Reference Object Example</h4>
 <pre class="nohighlight"><code>
-{
-	<span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+	<span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">&#x27;#/components/schemas/Pet&#x27;</span>
 </code></pre>
 </section><section><h4>Relative Schema Document Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;Pet.json&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Pet.json&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">Pet.yaml</span>
 </code></pre>
 </section><section><h4>Relative Documents With Embedded Schema Example</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;definitions.json#/Pet&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-string">$ref:</span> <span class="hljs-string">definitions.yaml#/Pet</span>
 </code></pre>
-</section></section><section><h3><span id="schemaObject">Schema Object</span></h3>
+<p><a id="schemaObject"></a></section></section><section><h3><span>Schema Object</span></h3></p>
 <p>The Schema Object allows the definition of input and output data types.
 These types can be objects, but also primitives and arrays. This object is a superset of the <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00">JSON Schema Specification Draft 2020-12</a>.</p>
 <p>For more information about the properties, see <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-00">JSON Schema Core</a> and <a href="https://tools.ietf.org/html/draft-bhutton-json-schema-validation-00">JSON Schema Validation</a>.</p>
@@ -2839,7 +2839,7 @@
 </ul>
 <p>In addition to the JSON Schema properties comprising the OAS dialect, the Schema Object supports keywords from any other vocabularies, or entirely arbitrary properties.</p>
 <p>The OpenAPI Specification’s base vocabulary is comprised of the following keywords:</p>
-</section><section><h4><span id="baseVocabulary">Fixed Fields</span></h4>
+<p><a id="baseVocabulary"></a></section><section><h4><span>Fixed Fields</span></h4></p>
 <table>
 <thead>
 <tr>
@@ -2872,7 +2872,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>, though as noted, additional properties MAY omit the <code>x-</code> prefix within this object.</p>
-<section><h5><span id="schemaComposition">Composition and Inheritance (Polymorphism)</span></h5>
+<p><a id="schemaComposition"></a><section><h5><span>Composition and Inheritance (Polymorphism)</span></h5></p>
 <p>The OpenAPI Specification allows combining and extending model definitions using the <code>allOf</code> property of JSON Schema, in effect offering model composition.
 <code>allOf</code> takes an array of object definitions that are validated <em>independently</em> but together compose a single object.</p>
 <p>While composition offers model extensibility, it does not imply a hierarchy between the models.
@@ -2896,10 +2896,10 @@
 </section></section><section><h4>Schema Object Examples</h4>
 <section><h5>Primitive Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-  <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;email&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;email&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">string</span>
@@ -2907,25 +2907,25 @@
 </code></pre>
 </section><section><h5>Simple Model</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;address&quot;</span>: {
-      <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
-    },
-    <span class="hljs-attr">&quot;age&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-      <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-    }
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;address&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Address&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;age&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2944,12 +2944,12 @@
 </section><section><h5>Model with Map/Dictionary Properties</h5>
 <p>For a simple string to string mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2958,12 +2958,12 @@
 </code></pre>
 <p>For a string to model mapping:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;additionalProperties&quot;</span>: {
-    <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;additionalProperties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ComplexModel&quot;</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -2972,25 +2972,25 @@
 </code></pre>
 </section><section><h5>Model with Example</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-  <span class="hljs-attr">&quot;properties&quot;</span>: {
-    <span class="hljs-attr">&quot;id&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-      <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int64&quot;</span>
-    },
-    <span class="hljs-attr">&quot;name&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-  },
-  <span class="hljs-attr">&quot;required&quot;</span>: [
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int64&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
     <span class="hljs-string">&quot;name&quot;</span>
-  ],
-  <span class="hljs-attr">&quot;example&quot;</span>: {
-    <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;Puma&quot;</span>,
-    <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">1</span>
-  }
-}
+  <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;example&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Puma&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">1</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">object</span>
@@ -3008,47 +3008,47 @@
 </code></pre>
 </section><section><h5>Models with Composition</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;ErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;message&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;ErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;message&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;code&quot;</span>
-        ],
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;message&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;code&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-            <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">100</span>,
-            <span class="hljs-attr">&quot;maximum&quot;</span>: <span class="hljs-number">600</span>
-          }
-        }
-      },
-      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span>: {
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+        <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;message&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;code&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">100</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;maximum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">600</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;ExtendedErrorModel&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/ErrorModel&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;rootCause&quot;</span>
-            ],
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;rootCause&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-              }
-            }
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;rootCause&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3077,80 +3077,80 @@
 </code></pre>
 </section><section><h5>Models with Polymorphism Support</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;components&quot;</span>: {
-    <span class="hljs-attr">&quot;schemas&quot;</span>: {
-      <span class="hljs-attr">&quot;Pet&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-        <span class="hljs-attr">&quot;discriminator&quot;</span>: {
-          <span class="hljs-attr">&quot;propertyName&quot;</span>: <span class="hljs-string">&quot;petType&quot;</span>
-        },
-        <span class="hljs-attr">&quot;properties&quot;</span>: {
-          <span class="hljs-attr">&quot;name&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          },
-          <span class="hljs-attr">&quot;petType&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-          }
-        },
-        <span class="hljs-attr">&quot;required&quot;</span>: [
-          <span class="hljs-string">&quot;name&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;components&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;schemas&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;Pet&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;discriminator&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;propertyName&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;petType&quot;</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-string">&quot;name&quot;</span><span class="hljs-punctuation">,</span>
           <span class="hljs-string">&quot;petType&quot;</span>
-        ]
-      },
-      <span class="hljs-attr">&quot;Cat&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;huntingSkill&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;The measured skill for hunting&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-string">&quot;lazy&quot;</span>,
-                <span class="hljs-attr">&quot;enum&quot;</span>: [
-                  <span class="hljs-string">&quot;clueless&quot;</span>,
-                  <span class="hljs-string">&quot;lazy&quot;</span>,
-                  <span class="hljs-string">&quot;adventurous&quot;</span>,
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Cat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a cat. Note that `Cat` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;huntingSkill&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;The measured skill for hunting&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;enum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+                  <span class="hljs-string">&quot;clueless&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;lazy&quot;</span><span class="hljs-punctuation">,</span>
+                  <span class="hljs-string">&quot;adventurous&quot;</span><span class="hljs-punctuation">,</span>
                   <span class="hljs-string">&quot;aggressive&quot;</span>
-                ]
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+                <span class="hljs-punctuation">]</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;huntingSkill&quot;</span>
-            ]
-          }
-        ]
-      },
-      <span class="hljs-attr">&quot;Dog&quot;</span>: {
-        <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span>,
-        <span class="hljs-attr">&quot;allOf&quot;</span>: [
-          {
-            <span class="hljs-attr">&quot;$ref&quot;</span>: <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
-          },
-          {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-            <span class="hljs-attr">&quot;properties&quot;</span>: {
-              <span class="hljs-attr">&quot;packSize&quot;</span>: {
-                <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-                <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-                <span class="hljs-attr">&quot;description&quot;</span>: <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span>,
-                <span class="hljs-attr">&quot;default&quot;</span>: <span class="hljs-number">0</span>,
-                <span class="hljs-attr">&quot;minimum&quot;</span>: <span class="hljs-number">0</span>
-              }
-            },
-            <span class="hljs-attr">&quot;required&quot;</span>: [
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;Dog&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;A representation of a dog. Note that `Dog` will be used as the discriminator value.&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;allOf&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;$ref&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;#/components/schemas/Pet&quot;</span>
+          <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+              <span class="hljs-attr">&quot;packSize&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+                <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;description&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;the size of the pack the dog is from&quot;</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;default&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span><span class="hljs-punctuation">,</span>
+                <span class="hljs-attr">&quot;minimum&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">0</span>
+              <span class="hljs-punctuation">}</span>
+            <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+            <span class="hljs-attr">&quot;required&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
               <span class="hljs-string">&quot;packSize&quot;</span>
-            ]
-          }
-        ]
-      }
-    }
-  }
-}
+            <span class="hljs-punctuation">]</span>
+          <span class="hljs-punctuation">}</span>
+        <span class="hljs-punctuation">]</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">components:</span>
@@ -3198,7 +3198,7 @@
         <span class="hljs-attr">required:</span>
         <span class="hljs-bullet">-</span> <span class="hljs-string">packSize</span>
 </code></pre>
-</section></section></section><section><h3><span id="discriminatorObject">Discriminator Object</span></h3>
+<p><a id="discriminatorObject"></a></section></section></section><section><h3><span>Discriminator Object</span></h3></p>
 <p>When request bodies or response payloads may be one of a number of different schemas, a <code>discriminator</code> object can be used to aid in serialization, deserialization, and validation.  The discriminator is a specific object in a schema which is used to inform the consumer of the document of an alternative schema based on the value associated with it.</p>
 <p>When using the discriminator, <em>inline</em> schemas will not be considered.</p>
 <section><h4>Fixed Fields</h4>
@@ -3245,10 +3245,10 @@
 </code></pre>
 <p>The expectation now is that a property with name <code>petType</code> <em>MUST</em> be present in the response payload, and the value will correspond to the name of a schema defined in the OAS document.  Thus the response payload:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;id&quot;</span>: <span class="hljs-number">12345</span>,
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-number">12345</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>Will indicate that the <code>Cat</code> schema be used in conjunction with this payload.</p>
 <p>In scenarios where the value of the discriminator field does not match the schema name or implicit mapping is not possible, an optional <code>mapping</code> definition MAY be used:</p>
@@ -3310,20 +3310,20 @@
 </code></pre>
 <p>a payload like this:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;Cat&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;misty&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;Cat&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;misty&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will indicate that the <code>Cat</code> schema be used.  Likewise this schema:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petType&quot;</span>: <span class="hljs-string">&quot;dog&quot;</span>,
-  <span class="hljs-attr">&quot;bark&quot;</span>: <span class="hljs-string">&quot;soft&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petType&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;dog&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bark&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;soft&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <p>will map to <code>Dog</code> because of the definition in the <code>mapping</code> element.</p>
-</section></section><section><h3><span id="xmlObject">XML Object</span></h3>
+<p><a id="xmlObject"></a></section></section><section><h3><span>XML Object</span></h3></p>
 <p>A metadata object that allows for more fine-tuned XML model definitions.</p>
 <p>When using arrays, XML element names are <em>not</em> inferred (for singular/plural forms) and the <code>name</code> property SHOULD be used to add that information.
 See examples for expected behavior.</p>
@@ -3370,11 +3370,11 @@
 <section><h5>No XML Element</h5>
 <p>Basic string property:</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3385,14 +3385,14 @@
 </code></pre>
 <p>Basic string array property (<a href="#xmlWrapped"><code>wrapped</code></a> is <code>false</code> by default):</p>
 <pre class="nohighlight"><code>
-{
-    <span class="hljs-attr">&quot;animals&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-        <span class="hljs-attr">&quot;items&quot;</span>: {
-            <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-        }
-    }
-}
+<span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+            <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+        <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3407,14 +3407,14 @@
 </code></pre>
 </section><section><h5>XML Name Replacement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3428,27 +3428,27 @@
 </section><section><h5>XML Attribute, Prefix and Namespace</h5>
 <p>In this example, a full model definition is shown.</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;Person&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;object&quot;</span>,
-    <span class="hljs-attr">&quot;properties&quot;</span>: {
-      <span class="hljs-attr">&quot;id&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;integer&quot;</span>,
-        <span class="hljs-attr">&quot;format&quot;</span>: <span class="hljs-string">&quot;int32&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;attribute&quot;</span>: <span class="hljs-literal">true</span>
-        }
-      },
-      <span class="hljs-attr">&quot;name&quot;</span>: {
-        <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-        <span class="hljs-attr">&quot;xml&quot;</span>: {
-          <span class="hljs-attr">&quot;namespace&quot;</span>: <span class="hljs-string">&quot;https://example.com/schema/sample&quot;</span>,
-          <span class="hljs-attr">&quot;prefix&quot;</span>: <span class="hljs-string">&quot;sample&quot;</span>
-        }
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;Person&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;object&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;properties&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;id&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;integer&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;format&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;int32&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;attribute&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+          <span class="hljs-attr">&quot;namespace&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/schema/sample&quot;</span><span class="hljs-punctuation">,</span>
+          <span class="hljs-attr">&quot;prefix&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;sample&quot;</span>
+        <span class="hljs-punctuation">}</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">Person:</span>
@@ -3473,17 +3473,17 @@
 </section><section><h5>XML Arrays</h5>
 <p>Changing the element names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3499,20 +3499,20 @@
 </code></pre>
 <p>The external <code>name</code> property has no effect on the XML:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3530,17 +3530,17 @@
 </code></pre>
 <p>Even when the array is wrapped, if a name is not explicitly defined, the same name will be used both internally and externally:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3558,20 +3558,20 @@
 </code></pre>
 <p>To overcome the naming problem in the example above, the following definition can be used:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3591,21 +3591,21 @@
 </code></pre>
 <p>Affecting both internal and external names:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>,
-      <span class="hljs-attr">&quot;xml&quot;</span>: {
-        <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;animal&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;animal&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3626,18 +3626,18 @@
 </code></pre>
 <p>If we change the external element but not the internal ones:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;animals&quot;</span>: {
-    <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;array&quot;</span>,
-    <span class="hljs-attr">&quot;items&quot;</span>: {
-      <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;string&quot;</span>
-    },
-    <span class="hljs-attr">&quot;xml&quot;</span>: {
-      <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;aliens&quot;</span>,
-      <span class="hljs-attr">&quot;wrapped&quot;</span>: <span class="hljs-literal">true</span>
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;animals&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;array&quot;</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;items&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;string&quot;</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;xml&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;aliens&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;wrapped&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-literal"><span class="hljs-keyword">true</span></span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">animals:</span>
@@ -3654,7 +3654,7 @@
   <span class="hljs-tag">&lt;<span class="hljs-name">aliens</span>&gt;</span>value<span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 <span class="hljs-tag">&lt;/<span class="hljs-name">aliens</span>&gt;</span>
 </code></pre>
-</section></section></section><section><h3><span id="securitySchemeObject">Security Scheme Object</span></h3>
+<p><a id="securitySchemeObject"></a></section></section></section><section><h3><span>Security Scheme Object</span></h3></p>
 <p>Defines a security scheme that can be used by the operations.</p>
 <p>Supported schemes are HTTP authentication, an API key (either as a header, a cookie parameter or as a query parameter), mutual TLS (use of a client certificate), OAuth2’s common flows (implicit, password, client credentials and authorization code) as defined in [[!RFC6749]], and <a href="https://tools.ietf.org/html/draft-ietf-oauth-discovery-06">OpenID Connect Discovery</a>.
 Please note that as of 2020, the implicit flow is about to be deprecated by <a href="https://tools.ietf.org/html/draft-ietf-oauth-security-topics">OAuth 2.0 Security Best Current Practice</a>. Recommended for most use case is Authorization Code Grant flow with PKCE.</p>
@@ -3723,10 +3723,10 @@
 </section><section><h4>Security Scheme Object Example</h4>
 <section><h5>Basic Authentication Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;basic&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;basic&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3734,11 +3734,11 @@
 </code></pre>
 </section><section><h5>API Key Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;apiKey&quot;</span>,
-  <span class="hljs-attr">&quot;name&quot;</span>: <span class="hljs-string">&quot;api_key&quot;</span>,
-  <span class="hljs-attr">&quot;in&quot;</span>: <span class="hljs-string">&quot;header&quot;</span>
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;apiKey&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;name&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;api_key&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;in&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;header&quot;</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">apiKey</span>
@@ -3747,11 +3747,11 @@
 </code></pre>
 </section><section><h5>JWT Bearer Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;http&quot;</span>,
-  <span class="hljs-attr">&quot;scheme&quot;</span>: <span class="hljs-string">&quot;bearer&quot;</span>,
-  <span class="hljs-attr">&quot;bearerFormat&quot;</span>: <span class="hljs-string">&quot;JWT&quot;</span>,
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;http&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;scheme&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;bearer&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;bearerFormat&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;JWT&quot;</span><span class="hljs-punctuation">,</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">http</span>
@@ -3760,18 +3760,18 @@
 </code></pre>
 </section><section><h5>Implicit OAuth2 Sample</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3782,7 +3782,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span>
 </code></pre>
-</section></section></section><section><h3><span id="oauthFlowsObject">OAuth Flows Object</span></h3>
+<p><a id="oauthFlowsObject"></a></section></section></section><section><h3><span>OAuth Flows Object</span></h3></p>
 <p>Allows configuration of the supported OAuth Flows.</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3817,7 +3817,7 @@
 </tbody>
 </table>
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
-</section></section><section><h3><span id="oauthFlowObject">OAuth Flow Object</span></h3>
+<p><a id="oauthFlowObject"></a></section></section><section><h3><span>OAuth Flow Object</span></h3></p>
 <p>Configuration details for a supported OAuth Flow</p>
 <section><h4>Fixed Fields</h4>
 <table>
@@ -3859,26 +3859,26 @@
 <p>This object MAY be extended with <a href="#specificationExtensions">Specification Extensions</a>.</p>
 </section><section><h4>OAuth Flow Object Examples</h4>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;type&quot;</span>: <span class="hljs-string">&quot;oauth2&quot;</span>,
-  <span class="hljs-attr">&quot;flows&quot;</span>: {
-    <span class="hljs-attr">&quot;implicit&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    },
-    <span class="hljs-attr">&quot;authorizationCode&quot;</span>: {
-      <span class="hljs-attr">&quot;authorizationUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span>,
-      <span class="hljs-attr">&quot;tokenUrl&quot;</span>: <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span>,
-      <span class="hljs-attr">&quot;scopes&quot;</span>: {
-        <span class="hljs-attr">&quot;write:pets&quot;</span>: <span class="hljs-string">&quot;modify pets in your account&quot;</span>,
-        <span class="hljs-attr">&quot;read:pets&quot;</span>: <span class="hljs-string">&quot;read your pets&quot;</span>
-      }
-    }
-  }
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;type&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;oauth2&quot;</span><span class="hljs-punctuation">,</span>
+  <span class="hljs-attr">&quot;flows&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+    <span class="hljs-attr">&quot;implicit&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-attr">&quot;authorizationCode&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;authorizationUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/dialog&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;tokenUrl&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;https://example.com/api/oauth/token&quot;</span><span class="hljs-punctuation">,</span>
+      <span class="hljs-attr">&quot;scopes&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">{</span>
+        <span class="hljs-attr">&quot;write:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;modify pets in your account&quot;</span><span class="hljs-punctuation">,</span>
+        <span class="hljs-attr">&quot;read:pets&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-string">&quot;read your pets&quot;</span>
+      <span class="hljs-punctuation">}</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">}</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">type:</span> <span class="hljs-string">oauth2</span>
@@ -3895,7 +3895,7 @@
       <span class="hljs-attr">write:pets:</span> <span class="hljs-string">modify</span> <span class="hljs-string">pets</span> <span class="hljs-string">in</span> <span class="hljs-string">your</span> <span class="hljs-string">account</span>
       <span class="hljs-attr">read:pets:</span> <span class="hljs-string">read</span> <span class="hljs-string">your</span> <span class="hljs-string">pets</span> 
 </code></pre>
-</section></section><section><h3><span id="securityRequirementObject">Security Requirement Object</span></h3>
+<p><a id="securityRequirementObject"></a></section></section><section><h3><span>Security Requirement Object</span></h3></p>
 <p>Lists the required security schemes to execute this operation.
 The name used for each property MUST correspond to a security scheme declared in the <a href="#componentsSecuritySchemes">Security Schemes</a> under the <a href="#componentsObject">Components Object</a>.</p>
 <p>Security Requirement Objects that contain multiple schemes require that all schemes MUST be satisfied for a request to be authorized.
@@ -3921,21 +3921,21 @@
 </section><section><h4>Security Requirement Object Examples</h4>
 <section><h5>Non-OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;api_key&quot;</span>: []
-}
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;api_key&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span><span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">api_key:</span> []
 </code></pre>
 </section><section><h5>OAuth2 Security Requirement</h5>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-    <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
     <span class="hljs-string">&quot;read:pets&quot;</span>
-  ]
-}
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">petstore_auth:</span>
@@ -3945,17 +3945,17 @@
 </section><section><h5>Optional OAuth2 Security</h5>
 <p>Optional OAuth2 security as would be defined in an <a href="#openapi-object">OpenAPI Object</a> or an <a href="#operation-object">Operation Object</a>:</p>
 <pre class="nohighlight"><code>
-{
-  <span class="hljs-attr">&quot;security&quot;</span>: [
-    {},
-    {
-      <span class="hljs-attr">&quot;petstore_auth&quot;</span>: [
-        <span class="hljs-string">&quot;write:pets&quot;</span>,
+<span class="hljs-punctuation">{</span>
+  <span class="hljs-attr">&quot;security&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+    <span class="hljs-punctuation">{</span><span class="hljs-punctuation">}</span><span class="hljs-punctuation">,</span>
+    <span class="hljs-punctuation">{</span>
+      <span class="hljs-attr">&quot;petstore_auth&quot;</span><span class="hljs-punctuation">:</span> <span class="hljs-punctuation">[</span>
+        <span class="hljs-string">&quot;write:pets&quot;</span><span class="hljs-punctuation">,</span>
         <span class="hljs-string">&quot;read:pets&quot;</span>
-      ]
-    }
-  ]
-}
+      <span class="hljs-punctuation">]</span>
+    <span class="hljs-punctuation">}</span>
+  <span class="hljs-punctuation">]</span>
+<span class="hljs-punctuation">}</span>
 </code></pre>
 <pre class="nohighlight"><code>
 <span class="hljs-attr">security:</span>
@@ -3964,7 +3964,7 @@
     <span class="hljs-bullet">-</span> <span class="hljs-string">write:pets</span>
     <span class="hljs-bullet">-</span> <span class="hljs-string">read:pets</span>
 </code></pre>
-</section></section></section></section><section><h2><span id="specificationExtensions">Specification Extensions</span></h2>
+<p><a id="specificationExtensions"></a></section></section></section></section><section><h2><span>Specification Extensions</span></h2></p>
 <p>While the OpenAPI Specification tries to accommodate most use cases, additional data can be added to extend the specification at certain points.</p>
 <p>The extensions properties are implemented as patterned fields that are always prefixed by <code>&quot;x-&quot;</code>.</p>
 <table>
@@ -3984,7 +3984,7 @@
 </tbody>
 </table>
 <p>The extensions may or may not be supported by the available tooling, but those may be extended as well to add requested support (if tools are internal or open-sourced).</p>
-</section><section><h2><span id="securityFiltering">Security Filtering</span></h2>
+<p><a id="securityFiltering"></a></section><section><h2><span>Security Filtering</span></h2></p>
 <p>Some objects in the OpenAPI Specification MAY be declared and remain empty, or be completely removed, even though they are inherently the core of the API documentation.</p>
 <p>The reasoning is to allow an additional layer of access control over the documentation.
 While not part of the specification itself, certain libraries MAY choose to allow access to parts of the documentation based on some form of authentication/authorization.</p>
@@ -3993,7 +3993,7 @@
 <li>The <a href="#pathsObject">Paths Object</a> MAY be present but empty. It may be counterintuitive, but this may tell the viewer that they got to the right place, but can’t access any documentation. They would still have access to at least the <a href="#infoObject">Info Object</a> which may contain additional information regarding authentication.</li>
 <li>The <a href="#pathItemObject">Path Item Object</a> MAY be empty. In this case, the viewer will be aware that the path exists, but will not be able to see any of its operations or parameters. This is different from hiding the path itself from the <a href="#pathsObject">Paths Object</a>, because the user will be aware of its existence. This allows the documentation provider to finely control what the viewer can see.</li>
 </ol>
-</section></section><section><h1><span id="revisionHistory">Appendix A: Revision History</span></h1>
+<p><a id="revisionHistory"></a></section></section><section><h1><span>Appendix A: Revision History</span></h1></p>
 <table>
 <thead>
 <tr>
