docs: collect openapi-first wiki and refresh openapi-first lib docs; regenerate homepage

This commit is contained in:
2026-09-15 22:36:51 +05:30
parent 58544c4524
commit a51082fe77
83 changed files with 20049 additions and 535 deletions

View File

@@ -512,21 +512,6 @@
</span>
</a>
<nav class="md-nav" aria-label="MissingOperationHandler">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#openapi_first.errors.MissingOperationHandler-functions" class="md-nav__link">
<span class="md-ellipsis">
Functions
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
@@ -705,21 +690,6 @@
</span>
</a>
<nav class="md-nav" aria-label="MissingOperationHandler">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#openapi_first.errors.MissingOperationHandler-functions" class="md-nav__link">
<span class="md-ellipsis">
Functions
</span>
</a>
</li>
</ul>
</nav>
</li>
<li class="md-nav__item">
@@ -833,26 +803,6 @@ specification and its Python implementation.</p>
<p>Raised when an OpenAPI operation cannot be resolved to a handler.</p>
<details class="notes" open>
<summary>Notes</summary>
<p><strong>Scenarios:</strong></p>
<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- An OpenAPI operation does not define an `operationId`.
- An `operationId` is defined but no matching function exists in
the provided routes module.
</code></pre></div></td></tr></table></div>
<p><strong>Guarantees:</strong></p>
<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- This represents a violation of the OpenAPI-first contract and
indicates that the specification and implementation are out of
sync.
</code></pre></div></td></tr></table></div>
</details>
<p>Initialize the error.</p>
<p><span class="doc-section-title">Parameters:</span></p>
<table>
<thead>
@@ -910,6 +860,24 @@ specification and its Python implementation.</p>
</table>
<details class="notes" open>
<summary>Notes</summary>
<p><strong>Scenarios:</strong></p>
<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- An OpenAPI operation does not define an `operationId`.
- An `operationId` is defined but no matching function exists in
the provided routes module.
</code></pre></div></td></tr></table></div>
<p><strong>Guarantees:</strong></p>
<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span>
<span class="normal">2</span>
<span class="normal">3</span></pre></div></td><td class="code"><div><pre><span></span><code>- This represents a violation of the OpenAPI-first contract and
indicates that the specification and implementation are out of
sync.
</code></pre></div></td></tr></table></div>
</details>
<div class="doc doc-children">
@@ -920,7 +888,7 @@ specification and its Python implementation.</p>
<h5 id="openapi_first.errors.MissingOperationHandler-functions">Functions</h5>