docs(wiki): align wiki structure with Aetoskia AGENTS.md guidelines

- Renamed `02_architecture.md` to `02_components.md` to match the standard component page naming convention.
- Updated `docs/mkdocs.wiki.yml` to reflect renamed pages and fix navigation label acronym casing (GSDFC, MCP, MkDocs).
- Updated `index.md` to include the mandatory doc model blockquote, standardize section headers with emojis, and accurately map the `Documentation Structure` table to the navigation menu.
- Standardized all wiki pages (`01_overview.md`, `02_components.md`, `03_conventions.md`, `04_iterative_workflow.md`, and `05_development/*`) by:
  - Adding horizontal rules (`---`) between major sections.
  - Applying emoji-prefixed H2 headings for recognizable section types.
  - Appending `## Related` or `## ➡️ Read Next` footers with standard relative cross-links.
  - Adjusting H1 headers to match guide anatomy (e.g., `# Library Overview` on the overview page).
This commit is contained in:
2026-09-14 23:30:51 +05:30
parent 37f2fbf4b9
commit 48631b57c5
12 changed files with 896 additions and 701 deletions

View File

@@ -224,13 +224,13 @@
<li class="md-tabs__item">
<a href="../../02_architecture/" class="md-tabs__link">
<a href="../../02_components/" class="md-tabs__link">
Architecture
Components
</a>
</li>
@@ -385,12 +385,12 @@
<li class="md-nav__item">
<a href="../../02_architecture/" class="md-nav__link">
<a href="../../02_components/" class="md-nav__link">
<span class="md-ellipsis">
Architecture
Components
</span>
@@ -583,10 +583,28 @@
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#commands" class="md-nav__link">
<span class="md-ellipsis">
🚀 Commands
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#test-layout" class="md-nav__link">
<span class="md-ellipsis">
Test layout
📁 Test layout
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#related" class="md-nav__link">
<span class="md-ellipsis">
Related
</span>
</a>
@@ -613,7 +631,7 @@
<span class="md-ellipsis">
Gsdfc Guide
GSDFC Guide
</span>
@@ -636,7 +654,7 @@
<span class="md-ellipsis">
Mcp Guide
MCP Guide
</span>
@@ -659,7 +677,7 @@
<span class="md-ellipsis">
Mkdocs Configs
MkDocs Configs
</span>
@@ -695,6 +713,8 @@
<h1 id="quality-gates">Quality Gates</h1>
<p>Run all checks before pushing:</p>
<hr />
<h2 id="commands">🚀 Commands</h2>
<div class="language-bash highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-1">1</a></span>
<span class="normal"><a href="#__codelineno-0-2">2</a></span>
<span class="normal"><a href="#__codelineno-0-3">3</a></span>
@@ -705,7 +725,8 @@
</span><span id="__span-0-4"><a id="__codelineno-0-4" name="__codelineno-0-4"></a>.venv<span class="se">\S</span>cripts<span class="se">\p</span>ython.exe<span class="w"> </span>-m<span class="w"> </span>mypy<span class="w"> </span>docforge
</span><span id="__span-0-5"><a id="__codelineno-0-5" name="__codelineno-0-5"></a>.venv<span class="se">\S</span>cripts<span class="se">\p</span>ydoclint.exe<span class="w"> </span>docforge
</span></code></pre></div></td></tr></table></div>
<h2 id="test-layout">Test layout</h2>
<hr />
<h2 id="test-layout">📁 Test layout</h2>
<table>
<thead>
<tr>
@@ -731,6 +752,11 @@
<p>CLI tests use the <code>cli_runner</code> fixture with <code>mock_mkdocs_build</code> and
<code>mock_mkdocs_load_config</code> so they exercise the full flow without invoking a
real MkDocs build.</p>
<hr />
<h2 id="related">Related</h2>
<ul>
<li><a href="../01_environment/">01 – Environment</a> · <a href="../03_gsdfc_guide/">03 – GSDFC Guide</a></li>
</ul>