docs: refresh doc-forge library and MCP bundle

- collect regenerated doc-forge combined site (wiki + lib)
- drop stale lib/docforge duplicate subtree
- mcp bundle now uses docs:// module resources
This commit is contained in:
2026-09-12 13:12:55 +05:30
parent bd8ba6e67c
commit 167d44fcfe
107 changed files with 4754 additions and 40058 deletions

View File

@@ -343,6 +343,10 @@
@@ -427,6 +431,52 @@
<li class="md-nav__item">
<a href="../../../wiki/05_development/03_gsdfc_guide/" class="md-nav__link">
<span class="md-ellipsis">
Gsdfc Guide
</span>
</a>
</li>
<li class="md-nav__item">
<a href="../../../wiki/05_development/04_mcp_guide/" class="md-nav__link">
<span class="md-ellipsis">
Mcp Guide
</span>
</a>
</li>
</ul>
</nav>
@@ -1396,6 +1446,17 @@
<h3 id="docforge.cli.commands--summary">Summary</h3>
<p>Command definitions for the doc-forge CLI.</p>
<p>Provides the CLI structure using Click, including build, serve, and tree commands.</p>
<hr />
<details class="notes" open>
<summary>Notes</summary>
<ul>
<li>The <code>build</code> command validates requested modes before generating anything.</li>
<li><code>--mkdocs</code>, <code>--api</code>, and <code>--wiki</code> share a single MkDocs build; <code>--mcp</code>
generates a machine-readable bundle independently.</li>
</ul>
</details> <hr />
@@ -1455,9 +1516,9 @@
<div class="doc doc-contents ">
<p>Build documentation artifacts.</p>
<p>This command performs the full documentation build pipeline:
style of the selected platform, generates renderer-specific
documentation sources, and optionally builds the final output.</p>
<p>This command runs the full documentation pipeline: it loads Python
modules, generates renderer-specific documentation sources, and
optionally builds or serves the final output.</p>
<p>Depending on the selected options, the build can target:</p>
<ul>
<li>MkDocs static documentation sites for library reference docs</li>
@@ -1467,6 +1528,16 @@ documentation sources, and optionally builds the final output.</p>
</ul>
<details class="notes" open>
<summary>Notes</summary>
<ul>
<li>At least one of <code>--mcp</code>, <code>--mkdocs</code>, <code>--wiki</code>, or <code>--api</code> must be
provided.</li>
<li><code>--mkdocs</code>, <code>--api</code>, and <code>--wiki</code> are combined into a single MkDocs
build, while <code>--mcp</code> emits a machine-readable bundle.</li>
</ul>
</details>
<p><span class="doc-section-title">Parameters:</span></p>
<table>
<thead>
@@ -1551,7 +1622,7 @@ documentation sources, and optionally builds the final output.</p>
<tr class="doc-section-item">
<td><code>module</code></td>
<td>
<code>Optional[str]</code>
<code>str | None</code>
</td>
<td>
<div class="doc-md-description">
@@ -1565,7 +1636,7 @@ documentation sources, and optionally builds the final output.</p>
<tr class="doc-section-item">
<td><code>openapi_spec</code></td>
<td>
<code>Optional[<span title="pathlib.Path">Path</span>]</code>
<code><span title="pathlib.Path">Path</span> | None</code>
</td>
<td>
<div class="doc-md-description">
@@ -1579,7 +1650,7 @@ documentation sources, and optionally builds the final output.</p>
<tr class="doc-section-item">
<td><code>project_name</code></td>
<td>
<code>Optional[str]</code>
<code>str | None</code>
</td>
<td>
<div class="doc-md-description">
@@ -1593,7 +1664,7 @@ documentation sources, and optionally builds the final output.</p>
<tr class="doc-section-item">
<td><code>site_name</code></td>
<td>
<code>Optional[str]</code>
<code>str | None</code>
</td>
<td>
<div class="doc-md-description">
@@ -1649,7 +1720,7 @@ documentation sources, and optionally builds the final output.</p>
<tr class="doc-section-item">
<td><code>template</code></td>
<td>
<code>Optional[<span title="pathlib.Path">Path</span>]</code>
<code><span title="pathlib.Path">Path</span> | None</code>
</td>
<td>
<div class="doc-md-description">
@@ -1793,7 +1864,7 @@ documentation sources, and optionally builds the final output.</p>
<tr class="doc-section-item">
<td><code>module</code></td>
<td>
<code>Optional[str]</code>
<code>str | None</code>
</td>
<td>
<div class="doc-md-description">
@@ -1909,7 +1980,7 @@ objects, including modules, classes, functions, and members.</p>
<tr class="doc-section-item">
<td><code>project_name</code></td>
<td>
<code>Optional[str]</code>
<code>str | None</code>
</td>
<td>
<div class="doc-md-description">