From 8701bf92ac63f8e3ea5bf338b7f095d633f4cc91 Mon Sep 17 00:00:00 2001
From: Vishesh 'ironeagle' Bangotra <aetoskia@gmail.com>
Date: Sat, 7 Mar 2026 16:24:14 +0530
Subject: [PATCH] updated doc forge docs

---
 libs/doc-forge/site/404.html                  |  425 ++--
 libs/doc-forge/site/cli/commands/index.html   |  615 +++--
 libs/doc-forge/site/cli/index.html            |  551 ++---
 libs/doc-forge/site/cli/main/index.html       |  474 ++--
 libs/doc-forge/site/cli/mcp_utils/index.html  |  542 ++---
 .../site/cli/mkdocs_utils/index.html          |  653 ++---
 libs/doc-forge/site/index.html                | 2143 ++++++++++++-----
 .../site/loaders/griffe_loader/index.html     |  674 +++---
 libs/doc-forge/site/loaders/index.html        |  780 +++---
 libs/doc-forge/site/models/index.html         | 1051 ++++----
 libs/doc-forge/site/models/module/index.html  |  596 +++--
 libs/doc-forge/site/models/object/index.html  |  601 +++--
 libs/doc-forge/site/models/project/index.html |  591 +++--
 libs/doc-forge/site/nav/index.html            |  977 ++++----
 libs/doc-forge/site/nav/mkdocs/index.html     |  541 ++---
 libs/doc-forge/site/nav/resolver/index.html   |  612 +++--
 libs/doc-forge/site/nav/spec/index.html       |  646 ++---
 libs/doc-forge/site/objects.inv               |  Bin 1114 -> 1132 bytes
 libs/doc-forge/site/renderers/base/index.html |  604 ++---
 libs/doc-forge/site/renderers/index.html      |  810 +++----
 .../site/renderers/mcp_renderer/index.html    |  515 ++--
 .../site/renderers/mkdocs_renderer/index.html |  638 ++---
 libs/doc-forge/site/search/search_index.json  |    2 +-
 libs/doc-forge/site/servers/index.html        |  502 ++--
 .../site/servers/mcp_server/index.html        |  496 ++--
 libs/doc-forge/site/sitemap.xml.gz            |  Bin 127 -> 127 bytes
 26 files changed, 7831 insertions(+), 8208 deletions(-)

diff --git a/libs/doc-forge/site/404.html b/libs/doc-forge/site/404.html
index ccb63f2..da59a07 100644
--- a/libs/doc-forge/site/404.html
+++ b/libs/doc-forge/site/404.html
@@ -77,7 +77,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="/." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -142,12 +144,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -173,134 +182,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="/." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="/loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="/models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="/nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="/renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="/cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -314,10 +195,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="/." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -360,13 +239,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -375,8 +264,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="/loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -385,8 +275,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -396,27 +292,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -456,13 +331,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -471,8 +360,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="/models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -481,8 +371,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -492,27 +388,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -598,13 +473,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -613,8 +502,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="/nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -623,8 +513,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -634,27 +530,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -740,13 +615,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -755,8 +644,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="/renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -765,8 +655,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -776,27 +672,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -882,13 +757,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -897,8 +788,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="/cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -907,8 +799,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -918,27 +816,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="/cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1073,6 +950,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1110,7 +989,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "/", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "/assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "/", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "/assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="/assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/cli/commands/index.html b/libs/doc-forge/site/cli/commands/index.html
index 2d2edfb..fbf3b53 100644
--- a/libs/doc-forge/site/cli/commands/index.html
+++ b/libs/doc-forge/site/cli/commands/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -751,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -766,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -776,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -787,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -895,13 +768,26 @@
   
     
     
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
     
     
       
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -911,8 +797,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -921,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_6">
@@ -932,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1044,6 +916,25 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.commands-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.cli.commands-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.commands.build" class="md-nav__link">
     <span class="md-ellipsis">
       build
@@ -1073,6 +964,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1174,6 +1070,25 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.commands-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.cli.commands-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.commands.build" class="md-nav__link">
     <span class="md-ellipsis">
       build
@@ -1203,6 +1118,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1229,7 +1149,7 @@
 
 
 <h2 id="docforge.cli.commands" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.cli.commands</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.cli.commands</span>
 
 
 </h2>
@@ -1245,27 +1165,34 @@
 
 
 
-
-
+<h3 id="docforge.cli.commands-classes">Classes</h3>
+<h3 id="docforge.cli.commands-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.commands.build" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">build</span>
+<h4 id="docforge.cli.commands.build" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">build</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">build</span><span class="p">(</span><span class="n">mcp</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">mkdocs</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">module</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">site_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">nav_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">template</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">],</span> <span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">build</span><span class="p">(</span><span class="n">mcp</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">mkdocs</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">module</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">site_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">nav_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">template</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="n">Path</span><span class="p">],</span> <span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Build documentation (MkDocs site or MCP resources).</p>
-<p>This command orchestrates the full build process:
-1. Introspects the code (Griffe)
-2. Renders sources (MkDocs Markdown or MCP JSON)
-3. (MkDocs only) Generates config and runs the final site build.</p>
+      <p>Build documentation artifacts.</p>
+<p>This command performs the full documentation build pipeline:</p>
+<ol>
+<li>Introspects the Python project using Griffe</li>
+<li>Generates renderer-specific documentation sources</li>
+<li>Optionally builds the final documentation output</li>
+</ol>
+<p>Depending on the selected options, the build can target:</p>
+<ul>
+<li>MkDocs static documentation sites</li>
+<li>MCP structured documentation resources</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1286,7 +1213,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Use the MCP documentation builder.</p>
+                <p>Enable MCP documentation generation.</p>
               </div>
             </td>
             <td>
@@ -1300,7 +1227,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Use the MkDocs documentation builder.</p>
+                <p>Enable MkDocs documentation generation.</p>
               </div>
             </td>
             <td>
@@ -1314,7 +1241,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module is the source folder and to be treated as the root folder.</p>
+                <p>Treat the specified module directory as the
+project root.</p>
               </div>
             </td>
             <td>
@@ -1328,7 +1256,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module to the document.</p>
+                <p>Python module import path to document.</p>
               </div>
             </td>
             <td>
@@ -1356,7 +1284,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MkDocs) The site display name. Defaults to module name.</p>
+                <p>Display name for the MkDocs site.</p>
               </div>
             </td>
             <td>
@@ -1370,7 +1298,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MkDocs) Target directory for Markdown sources.</p>
+                <p>Directory where Markdown documentation sources
+will be generated.</p>
               </div>
             </td>
             <td>
@@ -1384,7 +1313,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MkDocs) Path to the docforge.nav.yml specification.</p>
+                <p>Path to the navigation specification file.</p>
               </div>
             </td>
             <td>
@@ -1398,7 +1327,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MkDocs) Optional custom mkdocs.yml template.</p>
+                <p>Optional custom MkDocs configuration template.</p>
               </div>
             </td>
             <td>
@@ -1412,7 +1341,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MkDocs) Target path for the generated mkdocs.yml.</p>
+                <p>Output path for the generated MkDocs configuration.</p>
               </div>
             </td>
             <td>
@@ -1426,7 +1355,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MCP) Target directory for MCP JSON resources.</p>
+                <p>Output directory for generated MCP resources.</p>
               </div>
             </td>
             <td>
@@ -1436,6 +1365,29 @@
       </tbody>
     </table>
 
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="click.UsageError">UsageError</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If required options are missing or conflicting.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
     </div>
 
 </div>
@@ -1443,17 +1395,22 @@
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.commands.serve" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">serve</span>
+<h4 id="docforge.cli.commands.serve" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">serve</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">serve</span><span class="p">(</span><span class="n">mcp</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">mkdocs</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">module</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">serve</span><span class="p">(</span><span class="n">mcp</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">mkdocs</span><span class="p">:</span> <span class="nb">bool</span><span class="p">,</span> <span class="n">module</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Serve documentation (MkDocs or MCP).</p>
+      <p>Serve generated documentation locally.</p>
+<p>Depending on the selected mode, this command starts either:</p>
+<ul>
+<li>A MkDocs development server for browsing documentation</li>
+<li>An MCP server exposing structured documentation resources</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1474,7 +1431,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Serve MCP resources via an MCP server.</p>
+                <p>Serve documentation using the MCP server.</p>
               </div>
             </td>
             <td>
@@ -1488,7 +1445,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Serve the MkDocs site using the built-in development server.</p>
+                <p>Serve the MkDocs development site.</p>
               </div>
             </td>
             <td>
@@ -1502,7 +1459,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module to serve.</p>
+                <p>Python module import path to serve via MCP.</p>
               </div>
             </td>
             <td>
@@ -1516,7 +1473,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MkDocs) Path to the mkdocs.yml configuration.</p>
+                <p>Path to the MkDocs configuration file.</p>
               </div>
             </td>
             <td>
@@ -1530,7 +1487,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>(MCP) Path to the mcp_docs/ directory.</p>
+                <p>Root directory containing MCP documentation resources.</p>
               </div>
             </td>
             <td>
@@ -1540,6 +1497,29 @@
       </tbody>
     </table>
 
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="click.UsageError">UsageError</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If invalid or conflicting options are provided.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
     </div>
 
 </div>
@@ -1547,17 +1527,20 @@
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.commands.tree" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">tree</span>
+<h4 id="docforge.cli.commands.tree" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">tree</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">tree</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">tree</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Visualize the project structure in the terminal.</p>
+      <p>Display the documentation object tree for a module.</p>
+<p>This command introspects the specified module and prints a
+hierarchical representation of the discovered documentation
+objects, including modules, classes, functions, and members.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1578,7 +1561,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The module import path to recursively introspect.</p>
+                <p>Python module import path to introspect.</p>
               </div>
             </td>
             <td>
@@ -1592,7 +1575,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Optional override for the project name shown at the root.</p>
+                <p>Optional name to display as the project root.</p>
               </div>
             </td>
             <td>
@@ -1630,6 +1613,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1667,7 +1652,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/cli/index.html b/libs/doc-forge/site/cli/index.html
index 2817e80..5c81206 100644
--- a/libs/doc-forge/site/cli/index.html
+++ b/libs/doc-forge/site/cli/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href=".." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href=".." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="./" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href=".." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -751,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -766,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -776,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -787,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -895,13 +768,26 @@
   
     
     
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
     
     
       
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -911,8 +797,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   
   <span class="md-ellipsis">
@@ -921,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_6">
@@ -932,108 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#docforge.cli" class="md-nav__link">
-    <span class="md-ellipsis">
-      cli
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="cli">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.cli--cli-layer" class="md-nav__link">
-    <span class="md-ellipsis">
-      CLI Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="CLI Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.cli--available-commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      Available Commands
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
             
               
                 
@@ -1171,27 +962,12 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge.cli--cli-layer" class="md-nav__link">
+  <a href="#docforge.cli--typical-usage" class="md-nav__link">
     <span class="md-ellipsis">
-      CLI Layer
+      Typical usage
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="CLI Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.cli--available-commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      Available Commands
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
 </li>
         
       </ul>
@@ -1223,22 +999,33 @@
 
 
 <h2 id="docforge.cli" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.cli</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.cli</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <h3 id="docforge.cli--cli-layer">CLI Layer</h3>
-<p>The <code>docforge.cli</code> package provides the command-line interface for interacting
-with doc-forge.</p>
-<h4 id="docforge.cli--available-commands">Available Commands</h4>
-<ul>
-<li><strong>build</strong>: Build documentation (MkDocs site or MCP resources).</li>
-<li><strong>serve</strong>: Serve documentation (MkDocs or MCP).</li>
-<li><strong>tree</strong>: Visualize the introspected project structure.</li>
-</ul>
+      <p>Command line interface entry point for doc-forge.</p>
+<p>This module exposes the primary CLI entry function used by the
+<code>doc-forge</code> command. The actual command implementation resides in
+<code>docforge.cli.main</code>, while this module provides a stable import path
+for external tools and the package entry point configuration.</p>
+<p>The CLI is responsible for orchestrating documentation workflows such as
+generating renderer sources, building documentation sites, exporting
+machine-readable documentation bundles, and starting development or MCP
+servers.</p>
+<hr />
+<h4 id="docforge.cli--typical-usage">Typical usage</h4>
+<p>The CLI is normally invoked through the installed command:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge &lt;command&gt; [options]
+</code></pre></div></td></tr></table></div>
+<p>Programmatic invocation is also possible:</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></pre></div></td><td class="code"><div><pre><span></span><code>from docforge.cli import main
+main()
+</code></pre></div></td></tr></table></div>
+<hr />
 
 
 
@@ -1276,6 +1063,8 @@ with doc-forge.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1313,7 +1102,7 @@ with doc-forge.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/cli/main/index.html b/libs/doc-forge/site/cli/main/index.html
index e6866da..b64095e 100644
--- a/libs/doc-forge/site/cli/main/index.html
+++ b/libs/doc-forge/site/cli/main/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -751,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -766,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -776,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -787,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -895,13 +768,26 @@
   
     
     
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
     
     
       
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -911,8 +797,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -921,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_6">
@@ -932,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1021,6 +893,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.main-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.main.main" class="md-nav__link">
     <span class="md-ellipsis">
       main
@@ -1032,6 +914,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1156,6 +1043,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.main-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.main.main" class="md-nav__link">
     <span class="md-ellipsis">
       main
@@ -1167,6 +1064,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1193,15 +1095,16 @@
 
 
 <h2 id="docforge.cli.main" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.cli.main</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.cli.main</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>Main entry point for the doc-forge CLI. This module delegates all command
-execution to docforge.cli.commands.</p>
+      <p>Command-line entry point for the doc-forge CLI.</p>
+<p>This module exposes the executable entry point that initializes the
+Click command group defined in <code>docforge.cli.commands</code>.</p>
 
 
 
@@ -1213,22 +1116,25 @@ execution to docforge.cli.commands.</p>
 
 
 
-
+<h3 id="docforge.cli.main-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.main.main" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">main</span>
+<h4 id="docforge.cli.main.main" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">main</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">main</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">main</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>CLI Entry point. Boots the click application.</p>
+      <p>Run the doc-forge command-line interface.</p>
+<p>This function initializes and executes the Click CLI application.
+It is used as the console entry point when invoking <code>doc-forge</code>
+from the command line.</p>
 
     </div>
 
@@ -1258,6 +1164,8 @@ execution to docforge.cli.commands.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1295,7 +1203,7 @@ execution to docforge.cli.commands.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/cli/mcp_utils/index.html b/libs/doc-forge/site/cli/mcp_utils/index.html
index 0247441..0ea734f 100644
--- a/libs/doc-forge/site/cli/mcp_utils/index.html
+++ b/libs/doc-forge/site/cli/mcp_utils/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -751,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -766,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -776,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -787,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -895,13 +768,26 @@
   
     
     
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
     
     
       
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -911,8 +797,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -921,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_6">
@@ -932,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1067,6 +939,25 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.mcp_utils-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.cli.mcp_utils-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.mcp_utils.generate_resources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_resources
@@ -1087,6 +978,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1165,6 +1061,25 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.mcp_utils-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.cli.mcp_utils-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.mcp_utils.generate_resources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_resources
@@ -1185,6 +1100,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1211,7 +1131,7 @@
 
 
 <h2 id="docforge.cli.mcp_utils" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.cli.mcp_utils</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.cli.mcp_utils</span>
 
 
 </h2>
@@ -1227,23 +1147,26 @@
 
 
 
-
-
+<h3 id="docforge.cli.mcp_utils-classes">Classes</h3>
+<h3 id="docforge.cli.mcp_utils-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.mcp_utils.generate_resources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_resources</span>
+<h4 id="docforge.cli.mcp_utils.generate_resources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">generate_resources</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_resources</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_resources</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate MCP-compatible documentation resources.</p>
+      <p>Generate MCP documentation resources from a Python module.</p>
+<p>The function performs project introspection, builds the internal
+documentation model, and renders MCP-compatible JSON resources
+to the specified output directory.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1264,7 +1187,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the primary module to document.</p>
+                <p>Python module import path used as the entry point for
+documentation generation.</p>
               </div>
             </td>
             <td>
@@ -1278,7 +1202,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Optional override for the project name.</p>
+                <p>Optional override for the project name used in
+generated documentation metadata.</p>
               </div>
             </td>
             <td>
@@ -1292,7 +1217,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Directory where the MCP JSON resources and nav will be written.</p>
+                <p>Directory where MCP resources (index.json, nav.json,
+and module data) will be written.</p>
               </div>
             </td>
             <td>
@@ -1309,17 +1235,19 @@
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.mcp_utils.serve" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">serve</span>
+<h4 id="docforge.cli.mcp_utils.serve" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">serve</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">serve</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">mcp_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">serve</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">mcp_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Serve MCP documentation from a pre-built bundle.</p>
+      <p>Start an MCP server for a pre-generated documentation bundle.</p>
+<p>The server exposes documentation resources such as project metadata,
+navigation structure, and module documentation through MCP endpoints.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1340,7 +1268,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the primary module to serve.</p>
+                <p>Python module import path used to identify the served
+documentation instance.</p>
               </div>
             </td>
             <td>
@@ -1354,7 +1283,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the directory containing index.json, nav.json, and modules/.</p>
+                <p>Path to the directory containing the MCP documentation
+bundle (index.json, nav.json, and modules/).</p>
               </div>
             </td>
             <td>
@@ -1364,6 +1294,30 @@
       </tbody>
     </table>
 
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="click.ClickException">ClickException</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the MCP documentation bundle is missing
+required files or directories.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
     </div>
 
 </div>
@@ -1392,6 +1346,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1429,7 +1385,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/cli/mkdocs_utils/index.html b/libs/doc-forge/site/cli/mkdocs_utils/index.html
index 3ecb2a5..40a6873 100644
--- a/libs/doc-forge/site/cli/mkdocs_utils/index.html
+++ b/libs/doc-forge/site/cli/mkdocs_utils/index.html
@@ -84,7 +84,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -149,12 +151,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -180,136 +189,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -323,10 +202,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -369,13 +246,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -384,8 +271,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -394,8 +282,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -405,27 +299,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -465,13 +338,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -480,8 +367,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -490,8 +378,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -501,27 +395,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -607,13 +480,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -622,8 +509,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -632,8 +520,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -643,27 +537,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -749,13 +622,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -764,8 +651,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -774,8 +662,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -785,27 +679,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -893,13 +766,26 @@
   
     
     
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
+      
+    
     
     
       
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -909,8 +795,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_6" checked>
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -919,8 +806,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_6">
@@ -930,27 +823,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1088,6 +960,25 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.mkdocs_utils-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.cli.mkdocs_utils-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.mkdocs_utils.build" class="md-nav__link">
     <span class="md-ellipsis">
       build
@@ -1126,6 +1017,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1181,6 +1077,25 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.cli.mkdocs_utils-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.cli.mkdocs_utils-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.cli.mkdocs_utils.build" class="md-nav__link">
     <span class="md-ellipsis">
       build
@@ -1219,6 +1134,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1245,7 +1165,7 @@
 
 
 <h2 id="docforge.cli.mkdocs_utils" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.cli.mkdocs_utils</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.cli.mkdocs_utils</span>
 
 
 </h2>
@@ -1261,23 +1181,25 @@
 
 
 
-
-
+<h3 id="docforge.cli.mkdocs_utils-classes">Classes</h3>
+<h3 id="docforge.cli.mkdocs_utils-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.mkdocs_utils.build" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">build</span>
+<h4 id="docforge.cli.mkdocs_utils.build" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">build</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">build</span><span class="p">(</span><span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">build</span><span class="p">(</span><span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Build the documentation site using MkDocs.</p>
+      <p>Build the MkDocs documentation site.</p>
+<p>This function loads the MkDocs configuration and runs the MkDocs
+build command to generate the final static documentation site.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1298,7 +1220,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the mkdocs.yml configuration file.</p>
+                <p>Path to the <code>mkdocs.yml</code> configuration file.</p>
               </div>
             </td>
             <td>
@@ -1308,6 +1230,29 @@
       </tbody>
     </table>
 
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="click.ClickException">ClickException</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the configuration file does not exist.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
     </div>
 
 </div>
@@ -1315,17 +1260,20 @@
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.mkdocs_utils.generate_config" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_config</span>
+<h4 id="docforge.cli.mkdocs_utils.generate_config" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">generate_config</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_config</span><span class="p">(</span><span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">nav_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">template</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">out</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">site_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_config</span><span class="p">(</span><span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">nav_file</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">template</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">out</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">site_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate an mkdocs.yml configuration file.</p>
+      <p>Generate an <code>mkdocs.yml</code> configuration file.</p>
+<p>The configuration is created by combining a template configuration
+with a navigation structure derived from the docforge navigation
+specification.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1346,7 +1294,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the directory containing documentation Markdown files.</p>
+                <p>Directory containing generated documentation Markdown files.</p>
               </div>
             </td>
             <td>
@@ -1360,7 +1308,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the docforge.nav.yml specification.</p>
+                <p>Path to the <code>docforge.nav.yml</code> navigation specification.</p>
               </div>
             </td>
             <td>
@@ -1374,7 +1322,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Optional path to an mkdocs.yml template (overrides built-in).</p>
+                <p>Optional path to a custom MkDocs configuration template.
+If not provided, a built-in template will be used.</p>
               </div>
             </td>
             <td>
@@ -1388,7 +1337,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path where the final mkdocs.yml will be written.</p>
+                <p>Destination path where the generated <code>mkdocs.yml</code> file
+will be written.</p>
               </div>
             </td>
             <td>
@@ -1402,7 +1352,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The display name for the documentation site.</p>
+                <p>Display name for the generated documentation site.</p>
               </div>
             </td>
             <td>
@@ -1412,6 +1362,30 @@
       </tbody>
     </table>
 
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="click.FileError">FileError</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the navigation specification or template
+file cannot be found.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
     </div>
 
 </div>
@@ -1419,17 +1393,20 @@
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.mkdocs_utils.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h4 id="docforge.cli.mkdocs_utils.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">project_name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">project_name</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate Markdown source files for the specified module.</p>
+      <p>Generate MkDocs Markdown sources for a Python module.</p>
+<p>This function introspects the specified module, builds the internal
+documentation model, and renders Markdown documentation files for
+use with MkDocs.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1450,27 +1427,14 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the primary module to document.</p>
+                <p>Python module import path used as the entry point for
+documentation generation.</p>
               </div>
             </td>
             <td>
                 <em>required</em>
             </td>
           </tr>
-          <tr class="doc-section-item">
-            <td><code>project_name</code></td>
-            <td>
-                  <code>str | None</code>
-            </td>
-            <td>
-              <div class="doc-md-description">
-                <p>Optional override for the project name.</p>
-              </div>
-            </td>
-            <td>
-                  <code>None</code>
-            </td>
-          </tr>
           <tr class="doc-section-item">
             <td><code>docs_dir</code></td>
             <td>
@@ -1485,6 +1449,21 @@
                 <em>required</em>
             </td>
           </tr>
+          <tr class="doc-section-item">
+            <td><code>project_name</code></td>
+            <td>
+                  <code>str | None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Optional override for the project name used in
+documentation metadata.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
           <tr class="doc-section-item">
             <td><code>module_is_source</code></td>
             <td>
@@ -1492,7 +1471,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module is the source folder and to be treated as the root folder.</p>
+                <p>If True, treat the specified module directory as
+the project root rather than a nested module.</p>
               </div>
             </td>
             <td>
@@ -1509,17 +1489,19 @@
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.cli.mkdocs_utils.serve" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">serve</span>
+<h4 id="docforge.cli.mkdocs_utils.serve" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">serve</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">serve</span><span class="p">(</span><span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">serve</span><span class="p">(</span><span class="n">mkdocs_yml</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Serve the documentation site with live-reload using MkDocs.</p>
+      <p>Start an MkDocs development server with live reload.</p>
+<p>The server watches documentation files and automatically reloads
+the site when changes are detected.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1540,7 +1522,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the mkdocs.yml configuration file.</p>
+                <p>Path to the <code>mkdocs.yml</code> configuration file.</p>
               </div>
             </td>
             <td>
@@ -1550,6 +1532,29 @@
       </tbody>
     </table>
 
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="click.ClickException">ClickException</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the configuration file does not exist.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
     </div>
 
 </div>
@@ -1578,6 +1583,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1615,7 +1622,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/index.html b/libs/doc-forge/site/index.html
index aec0057..f8c8af4 100644
--- a/libs/doc-forge/site/index.html
+++ b/libs/doc-forge/site/index.html
@@ -84,7 +84,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -149,12 +151,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -180,136 +189,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-    
-  
-  
-    <li class="md-tabs__item md-tabs__item--active">
-      <a href="." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -323,10 +202,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -405,67 +282,6 @@
     <nav class="md-nav" aria-label="docforge">
       <ul class="md-nav__list">
         
-          <li class="md-nav__item">
-  <a href="#docforge--doc-forge" class="md-nav__link">
-    <span class="md-ellipsis">
-      doc-forge
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="doc-forge">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge--core-philosophy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Core Philosophy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--documentation-design" class="md-nav__link">
-    <span class="md-ellipsis">
-      Documentation Design
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Documentation Design">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge--for-humans-readability-structure" class="md-nav__link">
-    <span class="md-ellipsis">
-      For Humans (Readability &amp; Structure)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--for-llms-ai-native-knowledge" class="md-nav__link">
-    <span class="md-ellipsis">
-      For LLMs (AI-Native Knowledge)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--available-commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      Available Commands
-    </span>
-  </a>
-  
-</li>
-        
           <li class="md-nav__item">
   <a href="#docforge--installation" class="md-nav__link">
     <span class="md-ellipsis">
@@ -478,40 +294,161 @@
           <li class="md-nav__item">
   <a href="#docforge--quick-start" class="md-nav__link">
     <span class="md-ellipsis">
-      Quick Start
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--build-mcp-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build MCP resources
+      Quick start
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#docforge--serve-mcp-documentation" class="md-nav__link">
+  <a href="#docforge--core-concepts" class="md-nav__link">
     <span class="md-ellipsis">
-      Serve MCP documentation
+      Core concepts
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Serve MCP documentation">
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--architecture" class="md-nav__link">
+    <span class="md-ellipsis">
+      Architecture
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--rendering-pipeline" class="md-nav__link">
+    <span class="md-ellipsis">
+      Rendering pipeline
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--cli-usage" class="md-nav__link">
+    <span class="md-ellipsis">
+      CLI usage
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--public-api" class="md-nav__link">
+    <span class="md-ellipsis">
+      Public API
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--google-styled-doc-forge-convention-gsdfc" class="md-nav__link">
+    <span class="md-ellipsis">
+      Google-Styled Doc-Forge Convention (GSDFC)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Google-Styled Doc-Forge Convention (GSDFC)">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge--project-structure" class="md-nav__link">
+  <a href="#docforge--general-rules" class="md-nav__link">
     <span class="md-ellipsis">
-      Project Structure
+      General rules
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--package-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Package docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--module-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Module docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--class-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Class docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--function-and-method-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Function and method docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--property-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Property docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--attribute-documentation" class="md-nav__link">
+    <span class="md-ellipsis">
+      Attribute documentation
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--notes-subsection-grouping" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes subsection grouping
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--example-formatting" class="md-nav__link">
+    <span class="md-ellipsis">
+      Example formatting
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--separator-rules" class="md-nav__link">
+    <span class="md-ellipsis">
+      Separator rules
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--parsing-guarantees" class="md-nav__link">
+    <span class="md-ellipsis">
+      Parsing guarantees
     </span>
   </a>
   
@@ -522,6 +459,16 @@
   
 </li>
         
+          <li class="md-nav__item">
+  <a href="#docforge-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.GriffeLoader" class="md-nav__link">
     <span class="md-ellipsis">
@@ -533,6 +480,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.GriffeLoader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.GriffeLoader.load_module" class="md-nav__link">
     <span class="md-ellipsis">
       load_module
@@ -553,6 +510,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -566,6 +528,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.MCPRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.MCPRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -577,6 +549,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -589,6 +566,25 @@
     <nav class="md-nav" aria-label="MkDocsRenderer">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#docforge.MkDocsRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.MkDocsRenderer.generate_readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      generate_readme
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#docforge.MkDocsRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
@@ -603,6 +599,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.discover_module_paths" class="md-nav__link">
     <span class="md-ellipsis">
@@ -615,6 +631,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -633,13 +654,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -648,8 +679,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -658,8 +690,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -669,27 +707,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -729,13 +746,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -744,8 +775,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -754,8 +786,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -765,27 +803,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -871,13 +888,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -886,8 +917,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -896,8 +928,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -907,27 +945,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1013,13 +1030,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1028,8 +1059,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1038,8 +1070,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -1049,27 +1087,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1155,13 +1172,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1170,8 +1203,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1180,8 +1214,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1191,27 +1231,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1348,67 +1367,6 @@
     <nav class="md-nav" aria-label="docforge">
       <ul class="md-nav__list">
         
-          <li class="md-nav__item">
-  <a href="#docforge--doc-forge" class="md-nav__link">
-    <span class="md-ellipsis">
-      doc-forge
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="doc-forge">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge--core-philosophy" class="md-nav__link">
-    <span class="md-ellipsis">
-      Core Philosophy
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--documentation-design" class="md-nav__link">
-    <span class="md-ellipsis">
-      Documentation Design
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Documentation Design">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge--for-humans-readability-structure" class="md-nav__link">
-    <span class="md-ellipsis">
-      For Humans (Readability &amp; Structure)
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--for-llms-ai-native-knowledge" class="md-nav__link">
-    <span class="md-ellipsis">
-      For LLMs (AI-Native Knowledge)
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--available-commands" class="md-nav__link">
-    <span class="md-ellipsis">
-      Available Commands
-    </span>
-  </a>
-  
-</li>
-        
           <li class="md-nav__item">
   <a href="#docforge--installation" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1421,40 +1379,161 @@
           <li class="md-nav__item">
   <a href="#docforge--quick-start" class="md-nav__link">
     <span class="md-ellipsis">
-      Quick Start
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge--build-mcp-resources" class="md-nav__link">
-    <span class="md-ellipsis">
-      Build MCP resources
+      Quick start
     </span>
   </a>
   
 </li>
         
           <li class="md-nav__item">
-  <a href="#docforge--serve-mcp-documentation" class="md-nav__link">
+  <a href="#docforge--core-concepts" class="md-nav__link">
     <span class="md-ellipsis">
-      Serve MCP documentation
+      Core concepts
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Serve MCP documentation">
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--architecture" class="md-nav__link">
+    <span class="md-ellipsis">
+      Architecture
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--rendering-pipeline" class="md-nav__link">
+    <span class="md-ellipsis">
+      Rendering pipeline
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--cli-usage" class="md-nav__link">
+    <span class="md-ellipsis">
+      CLI usage
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--public-api" class="md-nav__link">
+    <span class="md-ellipsis">
+      Public API
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--google-styled-doc-forge-convention-gsdfc" class="md-nav__link">
+    <span class="md-ellipsis">
+      Google-Styled Doc-Forge Convention (GSDFC)
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Google-Styled Doc-Forge Convention (GSDFC)">
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge--project-structure" class="md-nav__link">
+  <a href="#docforge--general-rules" class="md-nav__link">
     <span class="md-ellipsis">
-      Project Structure
+      General rules
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--package-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Package docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--module-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Module docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--class-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Class docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--function-and-method-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Function and method docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--property-docstrings" class="md-nav__link">
+    <span class="md-ellipsis">
+      Property docstrings
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--attribute-documentation" class="md-nav__link">
+    <span class="md-ellipsis">
+      Attribute documentation
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--notes-subsection-grouping" class="md-nav__link">
+    <span class="md-ellipsis">
+      Notes subsection grouping
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--example-formatting" class="md-nav__link">
+    <span class="md-ellipsis">
+      Example formatting
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--separator-rules" class="md-nav__link">
+    <span class="md-ellipsis">
+      Separator rules
+    </span>
+  </a>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge--parsing-guarantees" class="md-nav__link">
+    <span class="md-ellipsis">
+      Parsing guarantees
     </span>
   </a>
   
@@ -1465,6 +1544,16 @@
   
 </li>
         
+          <li class="md-nav__item">
+  <a href="#docforge-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.GriffeLoader" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1476,6 +1565,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.GriffeLoader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.GriffeLoader.load_module" class="md-nav__link">
     <span class="md-ellipsis">
       load_module
@@ -1496,6 +1595,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1509,6 +1613,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.MCPRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.MCPRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -1520,6 +1634,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1532,6 +1651,25 @@
     <nav class="md-nav" aria-label="MkDocsRenderer">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#docforge.MkDocsRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.MkDocsRenderer.generate_readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      generate_readme
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#docforge.MkDocsRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1546,6 +1684,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.discover_module_paths" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1558,6 +1716,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1584,95 +1747,735 @@
 
 
 <h2 id="docforge" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <h3 id="docforge--doc-forge">doc-forge</h3>
-<p><code>doc-forge</code> is a renderer-agnostic Python documentation compiler designed for
-speed, flexibility, and beautiful output. It decouples the introspection of
-your code from the rendering process, allowing you to generate documentation
-for various platforms (starting with MkDocs) from a single internal models.</p>
-<h4 id="docforge--core-philosophy">Core Philosophy</h4>
-<p><code>doc-forge</code> operates on two fundamental principles:</p>
-<ol>
-<li><strong>The Atomic Unit is a Python Import Path</strong>: Documentation is organized around the semantic structure of your code (e.g., <code>mypackage.utils</code>), not the filesystem.</li>
-<li><strong>The Documentation Compiler Paradigm</strong>: We separate documentation into three distinct phases:<ul>
-<li><strong>Front-end (Introspection)</strong>: Static analysis of source code and docstrings.</li>
-<li><strong>Middle-end (Semantic Model)</strong>: A renderer-neutral internal representation.</li>
-<li><strong>Back-end (Renderers)</strong>: Generation of human-facing (MkDocs) or machine-facing (MCP) outputs.</li>
-</ul>
-</li>
-</ol>
-<h4 id="docforge--documentation-design">Documentation Design</h4>
-<p><code>doc-forge</code> is an "AI-Native" documentation compiler. To get the most out of it, design your docstrings with both humans and LLMs in mind:</p>
-<h5 id="docforge--for-humans-readability-structure">For Humans (Readability &amp; Structure)</h5>
-<ul>
-<li><strong><code>__init__.py</code> as Landing Pages</strong>: Use the docstring of your package's <code>__init__.py</code> as the home page. Include overviews, installation instructions, and high-level examples here.</li>
-<li><strong>Single Source of Truth</strong>: Keep all technical details in docstrings. This ensures your MkDocs/Sphinx sites stay in sync with the code.</li>
-<li><strong>Semantic Hierarchy</strong>: Use standard Markdown headers to structure complex module documentation.</li>
-</ul>
-<h5 id="docforge--for-llms-ai-native-knowledge">For LLMs (AI-Native Knowledge)</h5>
-<ul>
-<li><strong>Model Context Protocol (MCP)</strong>: <code>doc-forge</code> exports your docs as structured JSON. This allows AI agents to "understand" your API surface area without layout noise.</li>
-<li><strong>Canonical Paths</strong>: Use dotted import paths as primary identifiers. AI tools use these to link code usage to documentation.</li>
-<li><strong>Type Annotations</strong>: While not in docstrings, <code>doc-forge</code> (via Griffe) extracts signatures. Clean type hints dramatically improve an LLM's ability to generate correct code using your library.</li>
-</ul>
-<h4 id="docforge--available-commands">Available Commands</h4>
-<ul>
-<li><strong>build</strong>: Build documentation (MkDocs site or MCP resources).</li>
-<li><strong>serve</strong>: Serve documentation (MkDocs or MCP).</li>
-<li><strong>tree</strong>: Visualize the introspected project structure.</li>
-</ul>
+      <p>Renderer-agnostic Python documentation compiler that converts Python docstrings
+into structured documentation for both humans (MkDocs) and machines (MCP / AI agents).</p>
+<p><code>doc-forge</code> statically analyzes source code, builds a semantic model of modules,
+classes, functions, and attributes, and renders that model into documentation
+outputs without executing user code.</p>
+<hr />
 <h4 id="docforge--installation">Installation</h4>
-<p>Install using <code>pip</code> with the optional <code>mkdocs</code> dependencies for a complete setup:</p>
-<pre><code class="language-bash">pip install doc-forge
-</code></pre>
-<h4 id="docforge--quick-start">Quick Start</h4>
-<ol>
-<li>
-<p><strong>Build Documentation</strong>:
-    Introspect your package and generate documentation in one step:
-    ```bash
-    # Build MkDocs site
-    doc-forge build --mkdocs --module my_package --site-name "My Docs"</p>
-<h3 id="docforge--build-mcp-resources">Build MCP resources</h3>
-<p>doc-forge build --mcp --module my_package
-```</p>
-</li>
-<li>
-<p><strong>Define Navigation</strong>:
-    Create a <code>docforge.nav.yml</code> to organize your documentation:
-    <code>yaml
-    home: my_package/index.md
-    groups:
-      Core API:
-        - my_package/core/*.md
-      Utilities:
-        - my_package/utils.md</code></p>
-</li>
-<li>
-<p><strong>Preview</strong>:
-    ```bash
-    # Serve MkDocs site
-    doc-forge serve --mkdocs</p>
-<h3 id="docforge--serve-mcp-documentation">Serve MCP documentation</h3>
-<p>doc-forge serve --mcp
-```</p>
-</li>
-</ol>
-<h4 id="docforge--project-structure">Project Structure</h4>
+<p>Install using pip:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>pip install doc-forge
+</code></pre></div></td></tr></table></div>
+<hr />
+<h4 id="docforge--quick-start">Quick start</h4>
+<p>Generate a MkDocs site from a Python package:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge build --mkdocs --module my_package
+</code></pre></div></td></tr></table></div>
+<p>Generate MCP JSON documentation:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge build --mcp --module my_package
+</code></pre></div></td></tr></table></div>
+<p>Serve documentation locally:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge serve --mkdocs --module my_package
+</code></pre></div></td></tr></table></div>
+<hr />
+<h4 id="docforge--core-concepts">Core concepts</h4>
+<p><strong>Loader</strong></p>
+<p>Extracts symbols, signatures, and docstrings using static analysis.</p>
+<p><strong>Semantic model</strong></p>
+<p>Structured, renderer-agnostic representation of the API.</p>
+<p><strong>Renderer</strong></p>
+<p>Converts the semantic model into output formats such as MkDocs or MCP JSON.</p>
+<p><strong>Symbol</strong></p>
+<p>Any documentable object:</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>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><code>- module
+- class
+- function
+- method
+- property
+- attribute
+</code></pre></div></td></tr></table></div>
+<hr />
+<h4 id="docforge--architecture">Architecture</h4>
+<p><code>doc-forge</code> follows a compiler architecture:</p>
+<p>Front-end:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>Static analysis of modules, classes, functions, type hints, and docstrings.
+</code></pre></div></td></tr></table></div>
+<p>Middle-end:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>Builds a semantic model describing symbols and relationships.
+</code></pre></div></td></tr></table></div>
+<p>Back-end:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>Renders documentation using interchangeable renderers.
+</code></pre></div></td></tr></table></div>
+<p>This architecture ensures deterministic documentation generation.</p>
+<hr />
+<h4 id="docforge--rendering-pipeline">Rendering pipeline</h4>
+<p>Typical flow:</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>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span>
+<span class="normal">9</span></pre></div></td><td class="code"><div><pre><span></span><code>Python package
+    ↓
+Loader (static analysis)
+    ↓
+Semantic model
+    ↓
+Renderer
+    ↓
+MkDocs site or MCP JSON
+</code></pre></div></td></tr></table></div>
+<hr />
+<h4 id="docforge--cli-usage">CLI usage</h4>
+<p>Build MkDocs documentation:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge build --mkdocs --module my_package
+</code></pre></div></td></tr></table></div>
+<p>Build MCP documentation:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge build --mcp --module my_package
+</code></pre></div></td></tr></table></div>
+<p>Serve MkDocs locally:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>doc-forge serve --module my_package
+</code></pre></div></td></tr></table></div>
+<hr />
+<h4 id="docforge--public-api">Public API</h4>
+<p>Loaders:</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></pre></div></td><td class="code"><div><pre><span></span><code>GriffeLoader
+discover_module_paths
+</code></pre></div></td></tr></table></div>
+<p>Renderers:</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></pre></div></td><td class="code"><div><pre><span></span><code>MkDocsRenderer
+MCPRenderer
+</code></pre></div></td></tr></table></div>
+<p>CLI:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>main
+</code></pre></div></td></tr></table></div>
+<p>Models:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>models
+</code></pre></div></td></tr></table></div>
+<hr />
+<h3 id="docforge--google-styled-doc-forge-convention-gsdfc">Google-Styled Doc-Forge Convention (GSDFC)</h3>
+<p>GSDFC defines how docstrings must be written so they render correctly in MkDocs and remain machine-parsable by doc-forge and AI tooling.</p>
 <ul>
-<li><code>docforge.loaders</code>: Introspects source code using static analysis (<code>griffe</code>).</li>
-<li><code>docforge.models</code>: The internal representation of your project, modules, and objects.</li>
-<li><code>docforge.renderers</code>: Converters that turn the models into physical files.</li>
-<li><code>docforge.nav</code>: Managers for logical-to-physical path mapping and navigation.</li>
+<li>Docstrings are the single source of truth.</li>
+<li>doc-forge compiles docstrings but does not generate documentation content.</li>
+<li>Documentation follows the Python import hierarchy.</li>
+<li>Every public symbol should have a complete and accurate docstring.</li>
+</ul>
+<hr />
+<h4 id="docforge--general-rules">General rules</h4>
+<ul>
+<li>Use <strong>Markdown headings</strong> at package and module level.</li>
+<li>Use <strong>Google-style structured sections</strong> at class, function, and method level.</li>
+<li>Indent section contents using four spaces.</li>
+<li>Use type hints in signatures instead of duplicating types in prose.</li>
+<li>Write summaries in imperative form.</li>
+<li>Sections are separated by <code>---</code></li>
+</ul>
+<hr />
+<h4 id="docforge--package-docstrings">Package docstrings</h4>
+<ul>
+<li>Package docstrings act as the documentation home page.</li>
+</ul>
+<p>Recommended sections:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><code>## Summary
+## Installation
+## Quick start
+## Core concepts
+## Architecture
+## Rendering pipeline
+## CLI usage
+## Public API
+## Examples
+## Notes
+</code></pre></div></td></tr></table></div>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Package Doc String:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span>
+<span class="normal">23</span>
+<span class="normal">24</span>
+<span class="normal">25</span>
+<span class="normal">26</span>
+<span class="normal">27</span>
+<span class="normal">28</span>
+<span class="normal">29</span>
+<span class="normal">30</span>
+<span class="normal">31</span>
+<span class="normal">32</span></pre></div></td><td class="code"><div><pre><span></span><code>&#39;&#39;&#39;
+Foo-bar processing framework.
+
+Provides tools for defining Foo objects and executing Bar pipelines.
+
+---
+
+# Installation
+
+    pip install foo-bar
+
+---
+
+# Quick start
+
+    from foobar import Foo, BarEngine
+
+    foo = Foo(&quot;example&quot;)
+    engine = BarEngine([foo])
+
+    result = engine.run()
+
+---
+
+# Public API
+
+    Foo
+    Bar
+    BarEngine
+
+---
+&#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--module-docstrings">Module docstrings</h4>
+<ul>
+<li>Module docstrings describe a subsystem.</li>
+</ul>
+<p>Recommended sections:</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>
+<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code>## Summary
+## Examples
+## Notes
+## Public API
+</code></pre></div></td></tr></table></div>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Module Doc String:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span></pre></div></td><td class="code"><div><pre><span></span><code>&#39;&#39;&#39;
+Foo execution subsystem.
+
+Provides utilities for executing Foo objects through Bar stages.
+
+---
+
+Example:
+
+    from foobar.engine import BarEngine
+    from foobar.foo import Foo
+
+    foo = Foo(&quot;example&quot;)
+
+    engine = BarEngine([foo])
+    engine.run()
+
+---
+&#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--class-docstrings">Class docstrings</h4>
+<ul>
+<li>Class docstrings define object responsibility, lifecycle, and attributes.</li>
+</ul>
+<p>Recommended sections:</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>
+<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code>Attributes:
+Notes:
+Example:
+Raises:
+</code></pre></div></td></tr></table></div>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Simple Foo:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span>
+<span class="normal">23</span>
+<span class="normal">24</span>
+<span class="normal">25</span>
+<span class="normal">26</span>
+<span class="normal">27</span></pre></div></td><td class="code"><div><pre><span></span><code>class Foo:
+    &#39;&#39;&#39;
+    Represents a unit of work.
+
+    Attributes:
+        name (str):
+            Identifier of the foo instance.
+
+        value (int):
+            Numeric value associated with foo.
+
+    Notes:
+        Guarantees:
+
+            - instances are immutable after creation
+
+        Lifecycle:
+
+            - create instance
+            - pass to processing engine
+
+    Example:
+        Create and inspect a Foo:
+
+            foo = Foo(&quot;example&quot;, value=42)
+            print(foo.name)
+    &#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+<p>Complex Bar:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span></pre></div></td><td class="code"><div><pre><span></span><code>class BarEngine:
+    &#39;&#39;&#39;
+    Executes Foo objects through Bar stages.
+
+    Attributes:
+        foos (tuple[Foo, ...]):
+            Foo instances managed by the engine.
+
+    Notes:
+        Guarantees:
+
+            - deterministic execution order
+
+    Example:
+        Run engine:
+
+            foo1 = Foo(&quot;a&quot;)
+            foo2 = Foo(&quot;b&quot;)
+
+            engine = BarEngine([foo1, foo2])
+            engine.run()
+    &#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--function-and-method-docstrings">Function and method docstrings</h4>
+<ul>
+<li>Function docstrings define API contracts.</li>
+</ul>
+<p>Recommended sections:</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>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span></pre></div></td><td class="code"><div><pre><span></span><code>Args:
+Returns:
+Raises:
+Yields:
+Notes:
+Example:
+</code></pre></div></td></tr></table></div>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Simple process method:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span>
+<span class="normal">23</span>
+<span class="normal">24</span>
+<span class="normal">25</span>
+<span class="normal">26</span>
+<span class="normal">27</span>
+<span class="normal">28</span>
+<span class="normal">29</span>
+<span class="normal">30</span>
+<span class="normal">31</span>
+<span class="normal">32</span></pre></div></td><td class="code"><div><pre><span></span><code>def process(foo: Foo, multiplier: int) -&gt; int:
+    &#39;&#39;&#39;
+    Process a Foo instance.
+
+    Args:
+        foo (Foo):
+            Foo instance to process.
+
+        multiplier (int):
+            Value used to scale foo.
+
+    Returns:
+        int:
+            Processed result.
+
+    Raises:
+        ValueError:
+            If multiplier is negative.
+
+    Notes:
+        Guarantees:
+
+            - foo is not modified
+
+    Example:
+        Process foo:
+
+            foo = Foo(&quot;example&quot;, value=10)
+
+            result = process(foo, multiplier=2)
+            print(result)
+    &#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+<p>Multiple Examples:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span>
+<span class="normal">15</span>
+<span class="normal">16</span>
+<span class="normal">17</span>
+<span class="normal">18</span>
+<span class="normal">19</span>
+<span class="normal">20</span>
+<span class="normal">21</span>
+<span class="normal">22</span>
+<span class="normal">23</span>
+<span class="normal">24</span>
+<span class="normal">25</span>
+<span class="normal">26</span>
+<span class="normal">27</span>
+<span class="normal">28</span></pre></div></td><td class="code"><div><pre><span></span><code>def combine(foo_a: Foo, foo_b: Foo) -&gt; Foo:
+    &#39;&#39;&#39;
+    Combine two Foo instances.
+
+    Args:
+        foo_a (Foo):
+            First foo.
+
+        foo_b (Foo):
+            Second foo.
+
+    Returns:
+        Foo:
+            Combined foo.
+
+    Example:
+        Basic usage:
+
+            foo1 = Foo(&quot;a&quot;)
+            foo2 = Foo(&quot;b&quot;)
+
+            combined = combine(foo1, foo2)
+
+        Pipeline usage:
+
+            engine = BarEngine([foo1, foo2])
+            engine.run()
+    &#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--property-docstrings">Property docstrings</h4>
+<ul>
+<li>Properties must document return values.</li>
 </ul>
 
 
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Property Doc String:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span>
+<span class="normal">14</span></pre></div></td><td class="code"><div><pre><span></span><code>@property
+def foos(self) -&gt; tuple[Foo, ...]:
+    &#39;&#39;&#39;
+    Return contained Foo instances.
+
+    Returns:
+        tuple[Foo, ...]:
+            Stored foo objects.
+
+    Example:
+        container = FooContainer()
+
+        foos = container.foos
+    &#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--attribute-documentation">Attribute documentation</h4>
+<ul>
+<li>Document attributes in class docstrings using Attributes:.</li>
+</ul>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Attribute Doc String:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span></pre></div></td><td class="code"><div><pre><span></span><code>&#39;&#39;&#39;
+Represents a processing stage.
+
+Attributes:
+    id (str):
+        Unique identifier.
+
+    enabled (bool):
+        Whether the stage is active.
+&#39;&#39;&#39;
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--notes-subsection-grouping">Notes subsection grouping</h4>
+<ul>
+<li>Group related information using labeled subsections.</li>
+</ul>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Notes Example:</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>
+<span class="normal"> 4</span>
+<span class="normal"> 5</span>
+<span class="normal"> 6</span>
+<span class="normal"> 7</span>
+<span class="normal"> 8</span>
+<span class="normal"> 9</span>
+<span class="normal">10</span>
+<span class="normal">11</span>
+<span class="normal">12</span>
+<span class="normal">13</span></pre></div></td><td class="code"><div><pre><span></span><code>Notes:
+    **Guarantees:**
+
+        - deterministic behavior
+
+    **Lifecycle:**
+
+        - created during initialization
+        - reused across executions
+
+    **Thread safety:**
+
+        - safe for concurrent reads
+</code></pre></div></td></tr></table></div>
+</details>      <hr />
+<h4 id="docforge--example-formatting">Example formatting</h4>
+<ul>
+<li>Use indentation for examples.</li>
+</ul>
+
+
+<details class="example" open>
+  <summary>Example</summary>
+  <p>Single example:</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>
+<span class="normal">4</span></pre></div></td><td class="code"><div><pre><span></span><code>Example:
+
+    foo = Foo(&quot;example&quot;)
+    process(foo, multiplier=2)
+</code></pre></div></td></tr></table></div>
+<p>Multiple examples:</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>
+<span class="normal">4</span>
+<span class="normal">5</span>
+<span class="normal">6</span>
+<span class="normal">7</span>
+<span class="normal">8</span>
+<span class="normal">9</span></pre></div></td><td class="code"><div><pre><span></span><code>Example:
+    Create foo:
+
+        foo = Foo(&quot;example&quot;)
+
+    Run engine:
+
+        engine = BarEngine([foo])
+        engine.run()
+</code></pre></div></td></tr></table></div>
+</details>      <p>Avoid fenced code blocks inside structured sections.</p>
+<hr />
+<h4 id="docforge--separator-rules">Separator rules</h4>
+<p>Use horizontal separators only at docstring root level to separate sections:</p>
+<div class="language-text highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><code>---
+</code></pre></div></td></tr></table></div>
+<p>Allowed locations:</p>
+<ul>
+<li>package docstrings</li>
+<li>module docstrings</li>
+<li>major documentation sections</li>
+</ul>
+<p>Do not use separators inside code sections.</p>
+<hr />
+<h4 id="docforge--parsing-guarantees">Parsing guarantees</h4>
+<p>GSDFC ensures doc-forge can deterministically extract:</p>
+<ul>
+<li>symbol kind (module, class, function, property, attribute)</li>
+<li>symbol name</li>
+<li>parameters</li>
+<li>return values</li>
+<li>attributes</li>
+<li>examples</li>
+<li>structured Notes subsections</li>
+</ul>
+<p>This enables:</p>
+<ul>
+<li>reliable MkDocs rendering</li>
+<li>deterministic MCP export</li>
+<li>accurate AI semantic interpretation</li>
+</ul>
+<hr />
+
+
+<details class="notes" open>
+  <summary>Notes</summary>
+  <ul>
+<li>doc-forge never executes analyzed modules.</li>
+<li>Documentation is generated entirely through static analysis.</li>
+</ul>
+</details>
+
 
   <div class="doc doc-children">
 
@@ -1681,26 +2484,31 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 
 
 
-
+<h3 id="docforge-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.GriffeLoader" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">GriffeLoader</span>
+<h4 id="docforge.GriffeLoader" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">GriffeLoader</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">GriffeLoader</span><span class="p">()</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">GriffeLoader</span><span class="p">()</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Loads Python modules and extracts documentation using the Griffe introspection engine.</p>
+      <p>Load Python modules using Griffe and convert them into doc-forge models.</p>
+<p>This loader uses the Griffe introspection engine to analyze Python source
+code and transform the extracted information into <code>Project</code>, <code>Module</code>,
+and <code>DocObject</code> instances used by doc-forge.</p>
 
-      <p>Initialize the GriffeLoader.</p>
+      <p>Initialize the Griffe-backed loader.</p>
+<p>Creates an internal Griffe loader instance with dedicated collections
+for modules and source lines.</p>
 
 
 
@@ -1713,22 +2521,24 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 
 
 
-
+<h5 id="docforge.GriffeLoader-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.GriffeLoader.load_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_module</span>
+<h6 id="docforge.GriffeLoader.load_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load a single module and convert its introspection data into the docforge models.</p>
+      <p>Load and convert a single Python module.</p>
+<p>The module is introspected using Griffe and then transformed into
+a doc-forge <code>Module</code> model.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1749,7 +2559,7 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module to load.</p>
+                <p>Dotted import path of the module.</p>
               </div>
             </td>
             <td>
@@ -1775,7 +2585,7 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A Module instance.</p>
+                <p>A populated <code>Module</code> instance.</p>
               </div>
             </td>
           </tr>
@@ -1789,17 +2599,20 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.GriffeLoader.load_project" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_project</span>
+<h6 id="docforge.GriffeLoader.load_project" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load_project</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_project</span><span class="p">(</span><span class="n">module_paths</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">skip_import_errors</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Project</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_project</span><span class="p">(</span><span class="n">module_paths</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">skip_import_errors</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Project</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load multiple modules and combine them into a single Project models.</p>
+      <p>Load multiple modules and assemble them into a Project model.</p>
+<p>Each module path is introspected and converted into a <code>Module</code>
+instance. All modules are then aggregated into a single <code>Project</code>
+object.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1820,7 +2633,7 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of dotted paths to the modules to load.</p>
+                <p>List of dotted module import paths to load.</p>
               </div>
             </td>
             <td>
@@ -1834,7 +2647,8 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Optional name for the project. Defaults to the first module name.</p>
+                <p>Optional override for the project name. Defaults
+to the top-level name of the first module.</p>
               </div>
             </td>
             <td>
@@ -1848,7 +2662,8 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If True, modules that fail to import will be skipped.</p>
+                <p>If True, modules that fail to load will be
+skipped instead of raising an error.</p>
               </div>
             </td>
             <td>
@@ -1874,7 +2689,41 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A Project instance containing the loaded modules.</p>
+                <p>A populated <code>Project</code> instance containing the loaded modules.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ValueError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If no module paths are provided.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ImportError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If a module fails to load and
+<code>skip_import_errors</code> is False.</p>
               </div>
             </td>
           </tr>
@@ -1897,17 +2746,20 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 
 
 
-<h3 id="docforge.MCPRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MCPRenderer</span>
+<h4 id="docforge.MCPRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MCPRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Renderer that emits MCP-native JSON resources from docforge models.</p>
+      <p>Renderer that generates MCP-compatible documentation resources.</p>
+<p>This renderer converts doc-forge project models into structured JSON
+resources suitable for consumption by systems implementing the Model
+Context Protocol (MCP).</p>
 
 
 
@@ -1920,22 +2772,24 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 
 
 
-
+<h5 id="docforge.MCPRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.MCPRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.MCPRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate MCP-compatible JSON resources and navigation for the project.</p>
+      <p>Generate MCP documentation resources for a project.</p>
+<p>The renderer serializes each module into a JSON resource and produces
+supporting metadata files such as <code>nav.json</code> and <code>index.json</code>.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1956,7 +2810,7 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project model to render.</p>
+                <p>Documentation project model to render.</p>
               </div>
             </td>
             <td>
@@ -1970,7 +2824,7 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for the generated JSON files.</p>
+                <p>Directory where MCP resources will be written.</p>
               </div>
             </td>
             <td>
@@ -1996,18 +2850,19 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 
 
 
-<h3 id="docforge.MkDocsRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MkDocsRenderer</span>
+<h4 id="docforge.MkDocsRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MkDocsRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Renderer that generates Markdown source files formatted for the MkDocs
-'mkdocstrings' plugin.</p>
+      <p>Renderer that produces Markdown documentation for MkDocs.</p>
+<p>Generated pages use mkdocstrings directives to reference Python modules,
+allowing MkDocs to render API documentation dynamically.</p>
 
 
 
@@ -2020,23 +2875,28 @@ for various platforms (starting with MkDocs) from a single internal models.</p>
 
 
 
-
+<h5 id="docforge.MkDocsRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.MkDocsRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.MkDocsRenderer.generate_readme" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_readme</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_readme</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Produce a set of Markdown files in the output directory based on the
-provided Project models.</p>
+      <p>Generate a <code>README.md</code> file from the root module docstring.</p>
+<p>Behavior:</p>
+<ul>
+<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the
+  project root directory.</li>
+<li>If False, README generation is currently not implemented.</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2057,7 +2917,7 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project models to render.</p>
+                <p>Project model containing documentation metadata.</p>
               </div>
             </td>
             <td>
@@ -2065,13 +2925,13 @@ provided Project models.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>out_dir</code></td>
+            <td><code>docs_dir</code></td>
             <td>
                   <code><span title="pathlib.Path">Path</span></code>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for documentation files.</p>
+                <p>Directory containing generated documentation sources.</p>
               </div>
             </td>
             <td>
@@ -2085,7 +2945,88 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module is the source folder and to be treated as the root folder.</p>
+                <p>Whether the module is treated as the project
+source root.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h6 id="docforge.MkDocsRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+
+
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
+
+    <div class="doc doc-contents ">
+
+      <p>Generate Markdown documentation files for a project.</p>
+<p>This method renders a documentation structure from the provided
+project model and writes the resulting Markdown files to the
+specified output directory.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>project</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="docforge.models.Project" href="models/#docforge.models.Project">Project</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Project model containing modules to document.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>out_dir</code></td>
+            <td>
+                  <code><span title="pathlib.Path">Path</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Directory where generated Markdown files will be written.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>module_is_source</code></td>
+            <td>
+                  <code>bool | None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If True, treat the specified module as the
+documentation root rather than nesting it inside a folder.</p>
               </div>
             </td>
             <td>
@@ -2106,26 +3047,30 @@ provided Project models.</p>
     </div>
 
 </div>
-
+<h3 id="docforge-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.discover_module_paths" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">discover_module_paths</span>
+<h4 id="docforge.discover_module_paths" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">discover_module_paths</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">discover_module_paths</span><span class="p">(</span><span class="n">module_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">discover_module_paths</span><span class="p">(</span><span class="n">module_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Discover all Python modules under a package via filesystem traversal.</p>
-<p>Rules:
-- Directory with <strong>init</strong>.py is treated as a package.
-- Any .py file is treated as a module.
-- All paths are converted to dotted module paths.</p>
+      <p>Discover Python modules within a package directory.</p>
+<p>The function scans the filesystem for <code>.py</code> files inside the specified
+package and converts them into dotted module import paths.</p>
+<p>Discovery rules:</p>
+<ul>
+<li>Directories containing <code>__init__.py</code> are treated as packages.</li>
+<li>Each <code>.py</code> file is treated as a module.</li>
+<li>Results are returned as dotted import paths.</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2146,7 +3091,7 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the package to discover.</p>
+                <p>Top-level package name to discover modules from.</p>
               </div>
             </td>
             <td>
@@ -2160,7 +3105,8 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root directory of the project. Defaults to current working directory.</p>
+                <p>Root directory used to resolve module paths. If not
+provided, the current working directory is used.</p>
               </div>
             </td>
             <td>
@@ -2186,7 +3132,30 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A sorted list of dotted module paths.</p>
+                <p>A sorted list of unique dotted module import paths.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>FileNotFoundError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the specified package directory does not exist.</p>
               </div>
             </td>
           </tr>
@@ -2221,6 +3190,8 @@ provided Project models.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -2258,7 +3229,7 @@ provided Project models.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": ".", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": ".", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/loaders/griffe_loader/index.html b/libs/doc-forge/site/loaders/griffe_loader/index.html
index c11d133..b038ec3 100644
--- a/libs/doc-forge/site/loaders/griffe_loader/index.html
+++ b/libs/doc-forge/site/loaders/griffe_loader/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -372,6 +249,14 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
     
     
     
@@ -379,7 +264,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -389,8 +273,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -399,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2">
@@ -410,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -499,6 +369,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.loaders.griffe_loader-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.loaders.griffe_loader.GriffeLoader" class="md-nav__link">
     <span class="md-ellipsis">
       GriffeLoader
@@ -509,6 +389,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.loaders.griffe_loader.GriffeLoader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.loaders.griffe_loader.GriffeLoader.load_module" class="md-nav__link">
     <span class="md-ellipsis">
       load_module
@@ -531,6 +421,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.loaders.griffe_loader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.loaders.griffe_loader.discover_module_paths" class="md-nav__link">
     <span class="md-ellipsis">
@@ -543,6 +453,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -569,13 +484,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -584,8 +513,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -594,8 +524,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -605,27 +541,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -711,13 +626,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -726,8 +655,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -736,8 +666,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -747,27 +683,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -853,13 +768,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -868,8 +797,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -878,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -889,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -995,13 +910,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1010,8 +941,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1020,8 +952,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1031,27 +969,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1189,6 +1106,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.loaders.griffe_loader-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.loaders.griffe_loader.GriffeLoader" class="md-nav__link">
     <span class="md-ellipsis">
       GriffeLoader
@@ -1199,6 +1126,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.loaders.griffe_loader.GriffeLoader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.loaders.griffe_loader.GriffeLoader.load_module" class="md-nav__link">
     <span class="md-ellipsis">
       load_module
@@ -1221,6 +1158,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.loaders.griffe_loader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.loaders.griffe_loader.discover_module_paths" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1233,6 +1190,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1259,15 +1221,17 @@
 
 
 <h2 id="docforge.loaders.griffe_loader" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.loaders.griffe_loader</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.loaders.griffe_loader</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module provides the GriffeLoader, which uses the 'griffe' library to
-introspect Python source code and populate the doc-forge Project models.</p>
+      <p>Utilities for loading and introspecting Python modules using Griffe.</p>
+<p>This module provides the <code>GriffeLoader</code> class and helper utilities used to
+discover Python modules, introspect their structure, and convert the results
+into doc-forge documentation models.</p>
 
 
 
@@ -1278,26 +1242,31 @@ introspect Python source code and populate the doc-forge Project models.</p>
 
 
 
-
+<h3 id="docforge.loaders.griffe_loader-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.loaders.griffe_loader.GriffeLoader" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">GriffeLoader</span>
+<h4 id="docforge.loaders.griffe_loader.GriffeLoader" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">GriffeLoader</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">GriffeLoader</span><span class="p">()</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">GriffeLoader</span><span class="p">()</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Loads Python modules and extracts documentation using the Griffe introspection engine.</p>
+      <p>Load Python modules using Griffe and convert them into doc-forge models.</p>
+<p>This loader uses the Griffe introspection engine to analyze Python source
+code and transform the extracted information into <code>Project</code>, <code>Module</code>,
+and <code>DocObject</code> instances used by doc-forge.</p>
 
-      <p>Initialize the GriffeLoader.</p>
+      <p>Initialize the Griffe-backed loader.</p>
+<p>Creates an internal Griffe loader instance with dedicated collections
+for modules and source lines.</p>
 
 
 
@@ -1310,22 +1279,24 @@ introspect Python source code and populate the doc-forge Project models.</p>
 
 
 
-
+<h5 id="docforge.loaders.griffe_loader.GriffeLoader-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.loaders.griffe_loader.GriffeLoader.load_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_module</span>
+<h6 id="docforge.loaders.griffe_loader.GriffeLoader.load_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load a single module and convert its introspection data into the docforge models.</p>
+      <p>Load and convert a single Python module.</p>
+<p>The module is introspected using Griffe and then transformed into
+a doc-forge <code>Module</code> model.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1346,7 +1317,7 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module to load.</p>
+                <p>Dotted import path of the module.</p>
               </div>
             </td>
             <td>
@@ -1372,7 +1343,7 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A Module instance.</p>
+                <p>A populated <code>Module</code> instance.</p>
               </div>
             </td>
           </tr>
@@ -1386,17 +1357,20 @@ introspect Python source code and populate the doc-forge Project models.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.loaders.griffe_loader.GriffeLoader.load_project" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_project</span>
+<h6 id="docforge.loaders.griffe_loader.GriffeLoader.load_project" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load_project</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_project</span><span class="p">(</span><span class="n">module_paths</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">skip_import_errors</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Project</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_project</span><span class="p">(</span><span class="n">module_paths</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">skip_import_errors</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Project</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load multiple modules and combine them into a single Project models.</p>
+      <p>Load multiple modules and assemble them into a Project model.</p>
+<p>Each module path is introspected and converted into a <code>Module</code>
+instance. All modules are then aggregated into a single <code>Project</code>
+object.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1417,7 +1391,7 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of dotted paths to the modules to load.</p>
+                <p>List of dotted module import paths to load.</p>
               </div>
             </td>
             <td>
@@ -1431,7 +1405,8 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Optional name for the project. Defaults to the first module name.</p>
+                <p>Optional override for the project name. Defaults
+to the top-level name of the first module.</p>
               </div>
             </td>
             <td>
@@ -1445,7 +1420,8 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If True, modules that fail to import will be skipped.</p>
+                <p>If True, modules that fail to load will be
+skipped instead of raising an error.</p>
               </div>
             </td>
             <td>
@@ -1471,7 +1447,41 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A Project instance containing the loaded modules.</p>
+                <p>A populated <code>Project</code> instance containing the loaded modules.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ValueError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If no module paths are provided.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ImportError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If a module fails to load and
+<code>skip_import_errors</code> is False.</p>
               </div>
             </td>
           </tr>
@@ -1489,26 +1499,30 @@ introspect Python source code and populate the doc-forge Project models.</p>
     </div>
 
 </div>
-
+<h3 id="docforge.loaders.griffe_loader-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.loaders.griffe_loader.discover_module_paths" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">discover_module_paths</span>
+<h4 id="docforge.loaders.griffe_loader.discover_module_paths" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">discover_module_paths</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">discover_module_paths</span><span class="p">(</span><span class="n">module_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">discover_module_paths</span><span class="p">(</span><span class="n">module_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Discover all Python modules under a package via filesystem traversal.</p>
-<p>Rules:
-- Directory with <strong>init</strong>.py is treated as a package.
-- Any .py file is treated as a module.
-- All paths are converted to dotted module paths.</p>
+      <p>Discover Python modules within a package directory.</p>
+<p>The function scans the filesystem for <code>.py</code> files inside the specified
+package and converts them into dotted module import paths.</p>
+<p>Discovery rules:</p>
+<ul>
+<li>Directories containing <code>__init__.py</code> are treated as packages.</li>
+<li>Each <code>.py</code> file is treated as a module.</li>
+<li>Results are returned as dotted import paths.</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1529,7 +1543,7 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the package to discover.</p>
+                <p>Top-level package name to discover modules from.</p>
               </div>
             </td>
             <td>
@@ -1543,7 +1557,8 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root directory of the project. Defaults to current working directory.</p>
+                <p>Root directory used to resolve module paths. If not
+provided, the current working directory is used.</p>
               </div>
             </td>
             <td>
@@ -1569,7 +1584,30 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A sorted list of dotted module paths.</p>
+                <p>A sorted list of unique dotted module import paths.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>FileNotFoundError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the specified package directory does not exist.</p>
               </div>
             </td>
           </tr>
@@ -1604,6 +1642,8 @@ introspect Python source code and populate the doc-forge Project models.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1641,7 +1681,7 @@ introspect Python source code and populate the doc-forge Project models.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/loaders/index.html b/libs/doc-forge/site/loaders/index.html
index b2208f3..94cb51c 100644
--- a/libs/doc-forge/site/loaders/index.html
+++ b/libs/doc-forge/site/loaders/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href=".." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href=".." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="./" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href=".." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -372,6 +249,14 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
     
     
     
@@ -379,7 +264,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -389,8 +273,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2" checked>
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   
   <span class="md-ellipsis">
@@ -399,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_2">
@@ -410,150 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#docforge.loaders" class="md-nav__link">
-    <span class="md-ellipsis">
-      loaders
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="loaders">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.loaders--loader-layer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Loader Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Loader Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.loaders--core-features" class="md-nav__link">
-    <span class="md-ellipsis">
-      Core Features
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.loaders.GriffeLoader" class="md-nav__link">
-    <span class="md-ellipsis">
-      GriffeLoader
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="GriffeLoader">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.loaders.GriffeLoader.load_module" class="md-nav__link">
-    <span class="md-ellipsis">
-      load_module
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.loaders.GriffeLoader.load_project" class="md-nav__link">
-    <span class="md-ellipsis">
-      load_project
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.loaders.discover_module_paths" class="md-nav__link">
-    <span class="md-ellipsis">
-      discover_module_paths
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
             
               
                 
@@ -593,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -608,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -618,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -629,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -735,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -750,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -760,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -771,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -877,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -892,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -902,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -913,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1019,13 +766,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1034,8 +797,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1044,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1055,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1213,28 +962,23 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge.loaders--loader-layer" class="md-nav__link">
+  <a href="#docforge.loaders--overview" class="md-nav__link">
     <span class="md-ellipsis">
-      Loader Layer
+      Overview
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Loader Layer">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#docforge.loaders--core-features" class="md-nav__link">
+  <a href="#docforge.loaders-classes" class="md-nav__link">
     <span class="md-ellipsis">
-      Core Features
+      Classes
     </span>
   </a>
   
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
         
           <li class="md-nav__item">
   <a href="#docforge.loaders.GriffeLoader" class="md-nav__link">
@@ -1247,6 +991,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.loaders.GriffeLoader-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.loaders.GriffeLoader.load_module" class="md-nav__link">
     <span class="md-ellipsis">
       load_module
@@ -1269,6 +1023,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.loaders-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.loaders.discover_module_paths" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1281,6 +1055,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1307,25 +1086,30 @@
 
 
 <h2 id="docforge.loaders" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.loaders</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.loaders</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <h3 id="docforge.loaders--loader-layer">Loader Layer</h3>
-<p>The <code>docforge.loaders</code> package is responsible for discovering Python source files
-and extracting their documentation using static analysis.</p>
-<h4 id="docforge.loaders--core-features">Core Features</h4>
+      <p>Loader layer for doc-forge.</p>
+<p>The <code>docforge.loaders</code> package is responsible for discovering Python modules
+and extracting documentation data using static analysis.</p>
+<hr />
+<h4 id="docforge.loaders--overview">Overview</h4>
+<p>This layer converts Python source code into an intermediate documentation
+model used by doc-forge. It performs module discovery, introspection, and
+initial filtering before the data is passed to the core documentation models.</p>
+<p>Core capabilities include:</p>
 <ul>
-<li><strong>Discovery</strong>: Automatically find all modules and packages in a project
-  directory.</li>
-<li><strong>Introspection</strong>: Uses <code>griffe</code> to parse docstrings, signatures, and
-  hierarchical relationships without executing the code.</li>
-<li><strong>Filtering</strong>: Automatically excludes private members (prefixed with <code>_</code>) to
-  ensure clean public documentation.</li>
+<li><strong>Module discovery</strong> – Locate Python modules and packages within a project.</li>
+<li><strong>Static introspection</strong> – Parse docstrings, signatures, and object
+  hierarchies using the <code>griffe</code> library without executing the code.</li>
+<li><strong>Public API filtering</strong> – Exclude private members (names prefixed with
+  <code>_</code>) to produce clean public documentation structures.</li>
 </ul>
+<hr />
 
 
 
@@ -1336,26 +1120,31 @@ and extracting their documentation using static analysis.</p>
 
 
 
-
+<h3 id="docforge.loaders-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.loaders.GriffeLoader" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">GriffeLoader</span>
+<h4 id="docforge.loaders.GriffeLoader" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">GriffeLoader</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">GriffeLoader</span><span class="p">()</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">GriffeLoader</span><span class="p">()</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Loads Python modules and extracts documentation using the Griffe introspection engine.</p>
+      <p>Load Python modules using Griffe and convert them into doc-forge models.</p>
+<p>This loader uses the Griffe introspection engine to analyze Python source
+code and transform the extracted information into <code>Project</code>, <code>Module</code>,
+and <code>DocObject</code> instances used by doc-forge.</p>
 
-      <p>Initialize the GriffeLoader.</p>
+      <p>Initialize the Griffe-backed loader.</p>
+<p>Creates an internal Griffe loader instance with dedicated collections
+for modules and source lines.</p>
 
 
 
@@ -1368,22 +1157,24 @@ and extracting their documentation using static analysis.</p>
 
 
 
-
+<h5 id="docforge.loaders.GriffeLoader-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.loaders.GriffeLoader.load_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_module</span>
+<h6 id="docforge.loaders.GriffeLoader.load_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load a single module and convert its introspection data into the docforge models.</p>
+      <p>Load and convert a single Python module.</p>
+<p>The module is introspected using Griffe and then transformed into
+a doc-forge <code>Module</code> model.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1404,7 +1195,7 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module to load.</p>
+                <p>Dotted import path of the module.</p>
               </div>
             </td>
             <td>
@@ -1430,7 +1221,7 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A Module instance.</p>
+                <p>A populated <code>Module</code> instance.</p>
               </div>
             </td>
           </tr>
@@ -1444,17 +1235,20 @@ and extracting their documentation using static analysis.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.loaders.GriffeLoader.load_project" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_project</span>
+<h6 id="docforge.loaders.GriffeLoader.load_project" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load_project</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_project</span><span class="p">(</span><span class="n">module_paths</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">skip_import_errors</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Project</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_project</span><span class="p">(</span><span class="n">module_paths</span><span class="p">:</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">project_name</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">skip_import_errors</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Project</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load multiple modules and combine them into a single Project models.</p>
+      <p>Load multiple modules and assemble them into a Project model.</p>
+<p>Each module path is introspected and converted into a <code>Module</code>
+instance. All modules are then aggregated into a single <code>Project</code>
+object.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1475,7 +1269,7 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of dotted paths to the modules to load.</p>
+                <p>List of dotted module import paths to load.</p>
               </div>
             </td>
             <td>
@@ -1489,7 +1283,8 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Optional name for the project. Defaults to the first module name.</p>
+                <p>Optional override for the project name. Defaults
+to the top-level name of the first module.</p>
               </div>
             </td>
             <td>
@@ -1503,7 +1298,8 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If True, modules that fail to import will be skipped.</p>
+                <p>If True, modules that fail to load will be
+skipped instead of raising an error.</p>
               </div>
             </td>
             <td>
@@ -1529,7 +1325,41 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A Project instance containing the loaded modules.</p>
+                <p>A populated <code>Project</code> instance containing the loaded modules.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ValueError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If no module paths are provided.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ImportError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If a module fails to load and
+<code>skip_import_errors</code> is False.</p>
               </div>
             </td>
           </tr>
@@ -1547,26 +1377,30 @@ and extracting their documentation using static analysis.</p>
     </div>
 
 </div>
-
+<h3 id="docforge.loaders-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.loaders.discover_module_paths" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">discover_module_paths</span>
+<h4 id="docforge.loaders.discover_module_paths" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">discover_module_paths</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">discover_module_paths</span><span class="p">(</span><span class="n">module_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">discover_module_paths</span><span class="p">(</span><span class="n">module_name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">project_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Discover all Python modules under a package via filesystem traversal.</p>
-<p>Rules:
-- Directory with <strong>init</strong>.py is treated as a package.
-- Any .py file is treated as a module.
-- All paths are converted to dotted module paths.</p>
+      <p>Discover Python modules within a package directory.</p>
+<p>The function scans the filesystem for <code>.py</code> files inside the specified
+package and converts them into dotted module import paths.</p>
+<p>Discovery rules:</p>
+<ul>
+<li>Directories containing <code>__init__.py</code> are treated as packages.</li>
+<li>Each <code>.py</code> file is treated as a module.</li>
+<li>Results are returned as dotted import paths.</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1587,7 +1421,7 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the package to discover.</p>
+                <p>Top-level package name to discover modules from.</p>
               </div>
             </td>
             <td>
@@ -1601,7 +1435,8 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root directory of the project. Defaults to current working directory.</p>
+                <p>Root directory used to resolve module paths. If not
+provided, the current working directory is used.</p>
               </div>
             </td>
             <td>
@@ -1627,7 +1462,30 @@ and extracting their documentation using static analysis.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A sorted list of dotted module paths.</p>
+                <p>A sorted list of unique dotted module import paths.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>FileNotFoundError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the specified package directory does not exist.</p>
               </div>
             </td>
           </tr>
@@ -1662,6 +1520,8 @@ and extracting their documentation using static analysis.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1699,7 +1559,7 @@ and extracting their documentation using static analysis.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/models/index.html b/libs/doc-forge/site/models/index.html
index eaac0b5..be12b48 100644
--- a/libs/doc-forge/site/models/index.html
+++ b/libs/doc-forge/site/models/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href=".." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href=".." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="./" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href=".." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -468,6 +341,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -475,7 +360,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -485,8 +369,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   
   <span class="md-ellipsis">
@@ -495,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3">
@@ -506,243 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#docforge.models" class="md-nav__link">
-    <span class="md-ellipsis">
-      models
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="models">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models--model-layer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Model Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Model Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models--key-components" class="md-nav__link">
-    <span class="md-ellipsis">
-      Key Components
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.DocObject" class="md-nav__link">
-    <span class="md-ellipsis">
-      DocObject
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="DocObject">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.DocObject.add_member" class="md-nav__link">
-    <span class="md-ellipsis">
-      add_member
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.DocObject.get_all_members" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_all_members
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.DocObject.get_member" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_member
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Module" class="md-nav__link">
-    <span class="md-ellipsis">
-      Module
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Module">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Module.add_object" class="md-nav__link">
-    <span class="md-ellipsis">
-      add_object
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Module.get_all_objects" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_all_objects
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Module.get_object" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_object
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Project" class="md-nav__link">
-    <span class="md-ellipsis">
-      Project
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Project">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Project.add_module" class="md-nav__link">
-    <span class="md-ellipsis">
-      add_module
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Project.get_all_modules" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_all_modules
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Project.get_module" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_module
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.models.Project.get_module_list" class="md-nav__link">
-    <span class="md-ellipsis">
-      get_module_list
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
             
               
                 
@@ -828,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -843,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -853,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -864,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -970,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -985,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -995,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -1006,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1112,13 +766,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1127,8 +797,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1137,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1148,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1306,28 +962,23 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge.models--model-layer" class="md-nav__link">
+  <a href="#docforge.models--overview" class="md-nav__link">
     <span class="md-ellipsis">
-      Model Layer
+      Overview
     </span>
   </a>
   
-    <nav class="md-nav" aria-label="Model Layer">
-      <ul class="md-nav__list">
+</li>
         
           <li class="md-nav__item">
-  <a href="#docforge.models--key-components" class="md-nav__link">
+  <a href="#docforge.models-classes" class="md-nav__link">
     <span class="md-ellipsis">
-      Key Components
+      Classes
     </span>
   </a>
   
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
         
           <li class="md-nav__item">
   <a href="#docforge.models.DocObject" class="md-nav__link">
@@ -1340,6 +991,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.DocObject-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.DocObject.add_member" class="md-nav__link">
     <span class="md-ellipsis">
       add_member
@@ -1369,6 +1030,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1382,6 +1048,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.Module-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.Module.add_object" class="md-nav__link">
     <span class="md-ellipsis">
       add_object
@@ -1411,6 +1087,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1424,6 +1105,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.Project-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.Project.add_module" class="md-nav__link">
     <span class="md-ellipsis">
       add_module
@@ -1467,6 +1158,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1493,24 +1194,34 @@
 
 
 <h2 id="docforge.models" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.models</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.models</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <h3 id="docforge.models--model-layer">Model Layer</h3>
-<p>The <code>docforge.models</code> package provides the core data structures used to represent
-Python source code in a documentation-focused hierarchy.</p>
-<h4 id="docforge.models--key-components">Key Components</h4>
+      <p>Model layer for doc-forge.</p>
+<p>The <code>docforge.models</code> package defines the core data structures used to
+represent Python source code as a structured documentation model.</p>
+<hr />
+<h4 id="docforge.models--overview">Overview</h4>
+<p>The model layer forms the central intermediate representation used throughout
+doc-forge. Python modules and objects discovered during introspection are
+converted into a hierarchy of documentation models that can later be rendered
+into different documentation formats.</p>
+<p>Key components:</p>
 <ul>
-<li><strong>Project</strong>: The root container for all documented modules.</li>
-<li><strong>Module</strong>: Represents a Python module or package, containing members.</li>
-<li><strong>DocObject</strong>: A recursive structure for classes, functions, and attributes.</li>
+<li><strong>Project</strong> – Root container representing an entire documented codebase.</li>
+<li><strong>Module</strong> – Representation of a Python module or package containing
+  documented members.</li>
+<li><strong>DocObject</strong> – Recursive structure representing Python objects such as
+  classes, functions, methods, and attributes.</li>
 </ul>
-<p>These classes are designed to be renderer-agnostic, allowing the same internal
-representation to be transformed into various output formats (currently MkDocs).</p>
+<p>These models are intentionally <strong>renderer-agnostic</strong>, allowing the same
+documentation structure to be transformed into multiple output formats
+(e.g., MkDocs, MCP, or other renderers).</p>
+<hr />
 
 
 
@@ -1521,24 +1232,27 @@ representation to be transformed into various output formats (currently MkDocs).
 
 
 
-
+<h3 id="docforge.models-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.models.DocObject" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">DocObject</span>
+<h4 id="docforge.models.DocObject" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">DocObject</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">DocObject</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">kind</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">signature</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">DocObject</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">kind</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">signature</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a documented Python object (class, function, method, etc.).</p>
+      <p>Representation of a documented Python object.</p>
+<p>A <code>DocObject</code> models a single Python entity discovered during
+introspection. Objects may contain nested members, allowing the structure
+of modules, classes, and other containers to be represented recursively.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1569,7 +1283,8 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Type of object (e.g., 'class', 'function', 'attribute').</p>
+                <p>Type of object (for example <code>class</code>, <code>function</code>,
+<code>method</code>, or <code>attribute</code>).</p>
               </div>
             </td>
           </tr>
@@ -1580,7 +1295,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Full dotted import path to the object.</p>
+                <p>Fully qualified dotted path to the object.</p>
               </div>
             </td>
           </tr>
@@ -1591,7 +1306,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Callable signature, if applicable.</p>
+                <p>Callable signature if the object represents a callable.</p>
               </div>
             </td>
           </tr>
@@ -1602,7 +1317,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Raw docstring content extracted from the source.</p>
+                <p>Raw docstring text extracted from the source code.</p>
               </div>
             </td>
           </tr>
@@ -1613,14 +1328,14 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Dictionary mapping member names to their DocObject representations.</p>
+                <p>Mapping of member names to child <code>DocObject</code> instances.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a new DocObject.</p>
+      <p>Initialize a DocObject instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1641,7 +1356,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The local name of the object.</p>
+                <p>Local name of the object.</p>
               </div>
             </td>
             <td>
@@ -1655,7 +1370,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The kind of object (e.g., 'class', 'function').</p>
+                <p>Object type identifier (for example <code>class</code> or <code>function</code>).</p>
               </div>
             </td>
             <td>
@@ -1669,7 +1384,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The full dotted path to the object.</p>
+                <p>Fully qualified dotted path of the object.</p>
               </div>
             </td>
             <td>
@@ -1683,7 +1398,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The object's signature (for callable objects).</p>
+                <p>Callable signature if applicable.</p>
               </div>
             </td>
             <td>
@@ -1697,7 +1412,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The object's docstring, if any.</p>
+                <p>Documentation string associated with the object.</p>
               </div>
             </td>
             <td>
@@ -1718,22 +1433,24 @@ representation to be transformed into various output formats (currently MkDocs).
 
 
 
-
+<h5 id="docforge.models.DocObject-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.DocObject.add_member" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">add_member</span>
+<h6 id="docforge.models.DocObject.add_member" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">add_member</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">add_member</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">add_member</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Add a child member to this object (e.g., a method to a class).</p>
+      <p>Add a child documentation object.</p>
+<p>This is typically used when attaching methods to classes or
+nested objects to their parent containers.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1754,7 +1471,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The child DocObject to add.</p>
+                <p>Documentation object to add as a member.</p>
               </div>
             </td>
             <td>
@@ -1771,17 +1488,17 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.DocObject.get_all_members" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_all_members</span>
+<h6 id="docforge.models.DocObject.get_all_members" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_all_members</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_all_members</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_all_members</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all members of this object.</p>
+      <p>Return all child members of the object.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1799,7 +1516,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of child DocObject instances.</p>
+                <p>An iterable of <code>DocObject</code> instances representing nested members.</p>
               </div>
             </td>
           </tr>
@@ -1813,17 +1530,17 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.DocObject.get_member" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_member</span>
+<h6 id="docforge.models.DocObject.get_member" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_member</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_member</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_member</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Retrieve a child member by name.</p>
+      <p>Retrieve a member object by name.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1844,7 +1561,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the member.</p>
+                <p>Name of the member to retrieve.</p>
               </div>
             </td>
             <td>
@@ -1870,7 +1587,30 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The requested DocObject.</p>
+                <p>The corresponding <code>DocObject</code> instance.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>KeyError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the member does not exist.</p>
               </div>
             </td>
           </tr>
@@ -1893,18 +1633,21 @@ representation to be transformed into various output formats (currently MkDocs).
 
 
 
-<h3 id="docforge.models.Module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">Module</span>
+<h4 id="docforge.models.Module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">Module</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">Module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">Module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a documented Python module or package.</p>
+      <p>Representation of a documented Python module or package.</p>
+<p>A <code>Module</code> stores metadata about the module itself and maintains a
+collection of top-level documentation objects discovered during
+introspection.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1935,7 +1678,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module-level docstring content.</p>
+                <p>Module-level documentation string, if present.</p>
               </div>
             </td>
           </tr>
@@ -1946,14 +1689,15 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Dictionary mapping object names to their DocObject representations.</p>
+                <p>Mapping of object names to their corresponding
+<code>DocObject</code> representations.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a new Module.</p>
+      <p>Initialize a Module instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1974,7 +1718,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module.</p>
+                <p>Dotted import path identifying the module.</p>
               </div>
             </td>
             <td>
@@ -1988,7 +1732,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The module's docstring, if any.</p>
+                <p>Module-level documentation text, if available.</p>
               </div>
             </td>
             <td>
@@ -2009,18 +1753,18 @@ representation to be transformed into various output formats (currently MkDocs).
 
 
 
-
+<h5 id="docforge.models.Module-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Module.add_object" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">add_object</span>
+<h6 id="docforge.models.Module.add_object" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">add_object</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">add_object</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">add_object</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
@@ -2045,7 +1789,8 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The object to add.</p>
+                <p>Documentation object to register as a top-level
+member of the module.</p>
               </div>
             </td>
             <td>
@@ -2062,17 +1807,17 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Module.get_all_objects" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_all_objects</span>
+<h6 id="docforge.models.Module.get_all_objects" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_all_objects</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_all_objects</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_all_objects</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all top-level objects in the module.</p>
+      <p>Return all top-level documentation objects in the module.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -2090,7 +1835,17 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of DocObject instances.</p>
+                <p>An iterable of <code>DocObject</code> instances representing the</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.Iterable">Iterable</span>[<a class="autorefs autorefs-internal" title="docforge.models.object.DocObject" href="object/#docforge.models.object.DocObject">DocObject</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>module's public members.</p>
               </div>
             </td>
           </tr>
@@ -2104,17 +1859,17 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Module.get_object" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_object</span>
+<h6 id="docforge.models.Module.get_object" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_object</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_object</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_object</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Retrieve a member object by name.</p>
+      <p>Retrieve a documented object by name.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2135,7 +1890,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the object.</p>
+                <p>Name of the object to retrieve.</p>
               </div>
             </td>
             <td>
@@ -2161,7 +1916,30 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The requested DocObject.</p>
+                <p>The corresponding <code>DocObject</code> instance.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>KeyError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If no object with the given name exists.</p>
               </div>
             </td>
           </tr>
@@ -2184,18 +1962,20 @@ representation to be transformed into various output formats (currently MkDocs).
 
 
 
-<h3 id="docforge.models.Project" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">Project</span>
+<h4 id="docforge.models.Project" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">Project</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">Project</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">Project</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a documentation project, serving as a container for modules.</p>
+      <p>Representation of a documentation project.</p>
+<p>A <code>Project</code> serves as the root container for all modules discovered during
+introspection. Each module is stored by its dotted import path.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -2226,14 +2006,14 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Dictionary mapping module paths to Module instances.</p>
+                <p>Mapping of module paths to <code>Module</code> instances.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a new Project.</p>
+      <p>Initialize a Project instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2254,7 +2034,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the project.</p>
+                <p>Name used to identify the documentation project.</p>
               </div>
             </td>
             <td>
@@ -2275,22 +2055,22 @@ representation to be transformed into various output formats (currently MkDocs).
 
 
 
-
+<h5 id="docforge.models.Project-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Project.add_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">add_module</span>
+<h6 id="docforge.models.Project.add_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">add_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">add_module</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="n">Module</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">add_module</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="n">Module</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Add a module to the project.</p>
+      <p>Register a module in the project.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2311,7 +2091,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The module to add.</p>
+                <p>Module instance to add to the project.</p>
               </div>
             </td>
             <td>
@@ -2328,17 +2108,17 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Project.get_all_modules" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_all_modules</span>
+<h6 id="docforge.models.Project.get_all_modules" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_all_modules</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_all_modules</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Module</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_all_modules</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Module</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all modules in the project.</p>
+      <p>Return all modules contained in the project.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -2356,7 +2136,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of Module objects.</p>
+                <p>An iterable of <code>Module</code> instances.</p>
               </div>
             </td>
           </tr>
@@ -2370,13 +2150,13 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Project.get_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_module</span>
+<h6 id="docforge.models.Project.get_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
@@ -2401,7 +2181,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module (e.g., 'pkg.mod').</p>
+                <p>Fully qualified dotted module path (for example <code>pkg.module</code>).</p>
               </div>
             </td>
             <td>
@@ -2427,7 +2207,30 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The requested Module.</p>
+                <p>The corresponding <code>Module</code> instance.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>KeyError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the module does not exist in the project.</p>
               </div>
             </td>
           </tr>
@@ -2441,17 +2244,17 @@ representation to be transformed into various output formats (currently MkDocs).
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.Project.get_module_list" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_module_list</span>
+<h6 id="docforge.models.Project.get_module_list" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_module_list</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_module_list</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_module_list</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get the list of all module dotted paths.</p>
+      <p>Return the list of module import paths.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -2469,7 +2272,7 @@ representation to be transformed into various output formats (currently MkDocs).
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of module paths.</p>
+                <p>A list containing the dotted paths of all modules in the project.</p>
               </div>
             </td>
           </tr>
@@ -2513,6 +2316,8 @@ representation to be transformed into various output formats (currently MkDocs).
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -2550,7 +2355,7 @@ representation to be transformed into various output formats (currently MkDocs).
     
     
       
-      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/models/module/index.html b/libs/doc-forge/site/models/module/index.html
index aa0f705..8aefbe5 100644
--- a/libs/doc-forge/site/models/module/index.html
+++ b/libs/doc-forge/site/models/module/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -468,6 +341,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -475,7 +360,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -485,8 +369,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -495,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3">
@@ -506,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -595,6 +465,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.module-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.module.Module" class="md-nav__link">
     <span class="md-ellipsis">
       Module
@@ -605,6 +485,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.module.Module-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.module.Module.add_object" class="md-nav__link">
     <span class="md-ellipsis">
       add_object
@@ -639,6 +529,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -711,13 +611,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -726,8 +640,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -736,8 +651,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -747,27 +668,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -853,13 +753,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -868,8 +782,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -878,8 +793,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -889,27 +810,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -995,13 +895,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1010,8 +926,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1020,8 +937,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1031,27 +954,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1189,6 +1091,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.module-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.module.Module" class="md-nav__link">
     <span class="md-ellipsis">
       Module
@@ -1199,6 +1111,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.module.Module-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.module.Module.add_object" class="md-nav__link">
     <span class="md-ellipsis">
       add_object
@@ -1233,6 +1155,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1259,16 +1191,18 @@
 
 
 <h2 id="docforge.models.module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.models.module</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.models.module</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module defines the Module class, which represents a Python module or package
-in the doc-forge documentation models. It acts as a container for top-level
-documented objects.</p>
+      <p>Documentation model representing a Python module or package.</p>
+<p>This module defines the <code>Module</code> class used in the doc-forge documentation
+model. A <code>Module</code> acts as a container for top-level documented objects
+(classes, functions, variables, and other members) discovered during
+introspection.</p>
 
 
 
@@ -1279,24 +1213,27 @@ documented objects.</p>
 
 
 
-
+<h3 id="docforge.models.module-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.models.module.Module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">Module</span>
+<h4 id="docforge.models.module.Module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">Module</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">Module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">Module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a documented Python module or package.</p>
+      <p>Representation of a documented Python module or package.</p>
+<p>A <code>Module</code> stores metadata about the module itself and maintains a
+collection of top-level documentation objects discovered during
+introspection.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1327,7 +1264,7 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module-level docstring content.</p>
+                <p>Module-level documentation string, if present.</p>
               </div>
             </td>
           </tr>
@@ -1338,14 +1275,15 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Dictionary mapping object names to their DocObject representations.</p>
+                <p>Mapping of object names to their corresponding
+<code>DocObject</code> representations.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a new Module.</p>
+      <p>Initialize a Module instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1366,7 +1304,7 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module.</p>
+                <p>Dotted import path identifying the module.</p>
               </div>
             </td>
             <td>
@@ -1380,7 +1318,7 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The module's docstring, if any.</p>
+                <p>Module-level documentation text, if available.</p>
               </div>
             </td>
             <td>
@@ -1401,18 +1339,18 @@ documented objects.</p>
 
 
 
-
+<h5 id="docforge.models.module.Module-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.module.Module.add_object" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">add_object</span>
+<h6 id="docforge.models.module.Module.add_object" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">add_object</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">add_object</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">add_object</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
@@ -1437,7 +1375,8 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The object to add.</p>
+                <p>Documentation object to register as a top-level
+member of the module.</p>
               </div>
             </td>
             <td>
@@ -1454,17 +1393,17 @@ documented objects.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.module.Module.get_all_objects" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_all_objects</span>
+<h6 id="docforge.models.module.Module.get_all_objects" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_all_objects</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_all_objects</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_all_objects</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all top-level objects in the module.</p>
+      <p>Return all top-level documentation objects in the module.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1482,7 +1421,17 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of DocObject instances.</p>
+                <p>An iterable of <code>DocObject</code> instances representing the</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.Iterable">Iterable</span>[<a class="autorefs autorefs-internal" title="docforge.models.object.DocObject" href="../object/#docforge.models.object.DocObject">DocObject</a>]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>module's public members.</p>
               </div>
             </td>
           </tr>
@@ -1496,17 +1445,17 @@ documented objects.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.module.Module.get_object" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_object</span>
+<h6 id="docforge.models.module.Module.get_object" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_object</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_object</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_object</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Retrieve a member object by name.</p>
+      <p>Retrieve a documented object by name.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1527,7 +1476,7 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the object.</p>
+                <p>Name of the object to retrieve.</p>
               </div>
             </td>
             <td>
@@ -1553,7 +1502,30 @@ documented objects.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The requested DocObject.</p>
+                <p>The corresponding <code>DocObject</code> instance.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>KeyError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If no object with the given name exists.</p>
               </div>
             </td>
           </tr>
@@ -1597,6 +1569,8 @@ documented objects.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1634,7 +1608,7 @@ documented objects.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/models/object/index.html b/libs/doc-forge/site/models/object/index.html
index dd2c5ea..5d9886e 100644
--- a/libs/doc-forge/site/models/object/index.html
+++ b/libs/doc-forge/site/models/object/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -468,6 +341,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -475,7 +360,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -485,8 +369,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -495,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3">
@@ -506,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -618,6 +488,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.object-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.object.DocObject" class="md-nav__link">
     <span class="md-ellipsis">
       DocObject
@@ -628,6 +508,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.object.DocObject-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.object.DocObject.add_member" class="md-nav__link">
     <span class="md-ellipsis">
       add_member
@@ -662,6 +552,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -711,13 +611,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -726,8 +640,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -736,8 +651,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -747,27 +668,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -853,13 +753,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -868,8 +782,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -878,8 +793,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -889,27 +810,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -995,13 +895,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1010,8 +926,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1020,8 +937,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1031,27 +954,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1189,6 +1091,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.object-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.object.DocObject" class="md-nav__link">
     <span class="md-ellipsis">
       DocObject
@@ -1199,6 +1111,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.object.DocObject-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.object.DocObject.add_member" class="md-nav__link">
     <span class="md-ellipsis">
       add_member
@@ -1233,6 +1155,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1259,16 +1191,18 @@
 
 
 <h2 id="docforge.models.object" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.models.object</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.models.object</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module defines the DocObject class, the fundamental recursive unit of the
-doc-forge documentation models. A DocObject represents a single Python entity
-(class, function, method, or attribute) and its nested members.</p>
+      <p>Documentation model representing individual Python objects.</p>
+<p>This module defines the <code>DocObject</code> class, the fundamental recursive unit of
+the doc-forge documentation model. Each <code>DocObject</code> represents a Python
+entity such as a class, function, method, or attribute, and may contain nested
+members that form a hierarchical documentation structure.</p>
 
 
 
@@ -1279,24 +1213,27 @@ doc-forge documentation models. A DocObject represents a single Python entity
 
 
 
-
+<h3 id="docforge.models.object-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.models.object.DocObject" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">DocObject</span>
+<h4 id="docforge.models.object.DocObject" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">DocObject</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">DocObject</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">kind</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">signature</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">DocObject</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">kind</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">signature</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">docstring</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a documented Python object (class, function, method, etc.).</p>
+      <p>Representation of a documented Python object.</p>
+<p>A <code>DocObject</code> models a single Python entity discovered during
+introspection. Objects may contain nested members, allowing the structure
+of modules, classes, and other containers to be represented recursively.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1327,7 +1264,8 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Type of object (e.g., 'class', 'function', 'attribute').</p>
+                <p>Type of object (for example <code>class</code>, <code>function</code>,
+<code>method</code>, or <code>attribute</code>).</p>
               </div>
             </td>
           </tr>
@@ -1338,7 +1276,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Full dotted import path to the object.</p>
+                <p>Fully qualified dotted path to the object.</p>
               </div>
             </td>
           </tr>
@@ -1349,7 +1287,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Callable signature, if applicable.</p>
+                <p>Callable signature if the object represents a callable.</p>
               </div>
             </td>
           </tr>
@@ -1360,7 +1298,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Raw docstring content extracted from the source.</p>
+                <p>Raw docstring text extracted from the source code.</p>
               </div>
             </td>
           </tr>
@@ -1371,14 +1309,14 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Dictionary mapping member names to their DocObject representations.</p>
+                <p>Mapping of member names to child <code>DocObject</code> instances.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a new DocObject.</p>
+      <p>Initialize a DocObject instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1399,7 +1337,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The local name of the object.</p>
+                <p>Local name of the object.</p>
               </div>
             </td>
             <td>
@@ -1413,7 +1351,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The kind of object (e.g., 'class', 'function').</p>
+                <p>Object type identifier (for example <code>class</code> or <code>function</code>).</p>
               </div>
             </td>
             <td>
@@ -1427,7 +1365,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The full dotted path to the object.</p>
+                <p>Fully qualified dotted path of the object.</p>
               </div>
             </td>
             <td>
@@ -1441,7 +1379,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The object's signature (for callable objects).</p>
+                <p>Callable signature if applicable.</p>
               </div>
             </td>
             <td>
@@ -1455,7 +1393,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The object's docstring, if any.</p>
+                <p>Documentation string associated with the object.</p>
               </div>
             </td>
             <td>
@@ -1476,22 +1414,24 @@ doc-forge documentation models. A DocObject represents a single Python entity
 
 
 
-
+<h5 id="docforge.models.object.DocObject-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.object.DocObject.add_member" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">add_member</span>
+<h6 id="docforge.models.object.DocObject.add_member" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">add_member</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">add_member</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">add_member</span><span class="p">(</span><span class="n">obj</span><span class="p">:</span> <span class="n">DocObject</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Add a child member to this object (e.g., a method to a class).</p>
+      <p>Add a child documentation object.</p>
+<p>This is typically used when attaching methods to classes or
+nested objects to their parent containers.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1512,7 +1452,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The child DocObject to add.</p>
+                <p>Documentation object to add as a member.</p>
               </div>
             </td>
             <td>
@@ -1529,17 +1469,17 @@ doc-forge documentation models. A DocObject represents a single Python entity
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.object.DocObject.get_all_members" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_all_members</span>
+<h6 id="docforge.models.object.DocObject.get_all_members" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_all_members</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_all_members</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_all_members</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">DocObject</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all members of this object.</p>
+      <p>Return all child members of the object.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1557,7 +1497,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of child DocObject instances.</p>
+                <p>An iterable of <code>DocObject</code> instances representing nested members.</p>
               </div>
             </td>
           </tr>
@@ -1571,17 +1511,17 @@ doc-forge documentation models. A DocObject represents a single Python entity
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.object.DocObject.get_member" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_member</span>
+<h6 id="docforge.models.object.DocObject.get_member" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_member</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_member</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_member</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">DocObject</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Retrieve a child member by name.</p>
+      <p>Retrieve a member object by name.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1602,7 +1542,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the member.</p>
+                <p>Name of the member to retrieve.</p>
               </div>
             </td>
             <td>
@@ -1628,7 +1568,30 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The requested DocObject.</p>
+                <p>The corresponding <code>DocObject</code> instance.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>KeyError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the member does not exist.</p>
               </div>
             </td>
           </tr>
@@ -1672,6 +1635,8 @@ doc-forge documentation models. A DocObject represents a single Python entity
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1709,7 +1674,7 @@ doc-forge documentation models. A DocObject represents a single Python entity
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/models/project/index.html b/libs/doc-forge/site/models/project/index.html
index a8fdd85..6e9c046 100644
--- a/libs/doc-forge/site/models/project/index.html
+++ b/libs/doc-forge/site/models/project/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -468,6 +341,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -475,7 +360,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -485,8 +369,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -495,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_3">
@@ -506,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -641,6 +511,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.project-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.project.Project" class="md-nav__link">
     <span class="md-ellipsis">
       Project
@@ -651,6 +531,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.project.Project-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.project.Project.add_module" class="md-nav__link">
     <span class="md-ellipsis">
       add_module
@@ -694,6 +584,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -720,13 +620,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -735,8 +649,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -745,8 +660,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -756,27 +677,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -862,13 +762,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -877,8 +791,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -887,8 +802,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -898,27 +819,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1004,13 +904,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1019,8 +935,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1029,8 +946,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1040,27 +963,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1198,6 +1100,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.project-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.project.Project" class="md-nav__link">
     <span class="md-ellipsis">
       Project
@@ -1208,6 +1120,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.models.project.Project-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.models.project.Project.add_module" class="md-nav__link">
     <span class="md-ellipsis">
       add_module
@@ -1251,6 +1173,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1277,15 +1209,17 @@
 
 
 <h2 id="docforge.models.project" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.models.project</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.models.project</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module defines the Project class, the top-level container for a documented
-project. It aggregates multiple Module instances into a single named entity.</p>
+      <p>Documentation model representing a project.</p>
+<p>This module defines the <code>Project</code> class, the top-level container used by
+doc-forge to represent a documented codebase. A <code>Project</code> aggregates multiple
+modules and provides access to them through a unified interface.</p>
 
 
 
@@ -1296,24 +1230,26 @@ project. It aggregates multiple Module instances into a single named entity.</p>
 
 
 
-
+<h3 id="docforge.models.project-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.models.project.Project" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">Project</span>
+<h4 id="docforge.models.project.Project" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">Project</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">Project</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">Project</span><span class="p">(</span><span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a documentation project, serving as a container for modules.</p>
+      <p>Representation of a documentation project.</p>
+<p>A <code>Project</code> serves as the root container for all modules discovered during
+introspection. Each module is stored by its dotted import path.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1344,14 +1280,14 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Dictionary mapping module paths to Module instances.</p>
+                <p>Mapping of module paths to <code>Module</code> instances.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a new Project.</p>
+      <p>Initialize a Project instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1372,7 +1308,7 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The name of the project.</p>
+                <p>Name used to identify the documentation project.</p>
               </div>
             </td>
             <td>
@@ -1393,22 +1329,22 @@ project. It aggregates multiple Module instances into a single named entity.</p>
 
 
 
-
+<h5 id="docforge.models.project.Project-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.project.Project.add_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">add_module</span>
+<h6 id="docforge.models.project.Project.add_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">add_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">add_module</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="n">Module</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">add_module</span><span class="p">(</span><span class="n">module</span><span class="p">:</span> <span class="n">Module</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Add a module to the project.</p>
+      <p>Register a module in the project.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1429,7 +1365,7 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The module to add.</p>
+                <p>Module instance to add to the project.</p>
               </div>
             </td>
             <td>
@@ -1446,17 +1382,17 @@ project. It aggregates multiple Module instances into a single named entity.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.project.Project.get_all_modules" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_all_modules</span>
+<h6 id="docforge.models.project.Project.get_all_modules" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_all_modules</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_all_modules</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Module</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_all_modules</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Module</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all modules in the project.</p>
+      <p>Return all modules contained in the project.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1474,7 +1410,7 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of Module objects.</p>
+                <p>An iterable of <code>Module</code> instances.</p>
               </div>
             </td>
           </tr>
@@ -1488,13 +1424,13 @@ project. It aggregates multiple Module instances into a single named entity.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.project.Project.get_module" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_module</span>
+<h6 id="docforge.models.project.Project.get_module" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_module</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_module</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">Module</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
@@ -1519,7 +1455,7 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The dotted path of the module (e.g., 'pkg.mod').</p>
+                <p>Fully qualified dotted module path (for example <code>pkg.module</code>).</p>
               </div>
             </td>
             <td>
@@ -1545,7 +1481,30 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The requested Module.</p>
+                <p>The corresponding <code>Module</code> instance.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>KeyError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the module does not exist in the project.</p>
               </div>
             </td>
           </tr>
@@ -1559,17 +1518,17 @@ project. It aggregates multiple Module instances into a single named entity.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.models.project.Project.get_module_list" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">get_module_list</span>
+<h6 id="docforge.models.project.Project.get_module_list" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">get_module_list</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">get_module_list</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">get_module_list</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get the list of all module dotted paths.</p>
+      <p>Return the list of module import paths.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1587,7 +1546,7 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of module paths.</p>
+                <p>A list containing the dotted paths of all modules in the project.</p>
               </div>
             </td>
           </tr>
@@ -1631,6 +1590,8 @@ project. It aggregates multiple Module instances into a single named entity.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1668,7 +1629,7 @@ project. It aggregates multiple Module instances into a single named entity.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/nav/index.html b/libs/doc-forge/site/nav/index.html
index 9a2fee3..05a6e27 100644
--- a/libs/doc-forge/site/nav/index.html
+++ b/libs/doc-forge/site/nav/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href=".." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href=".." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="./" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href=".." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -610,6 +483,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -617,7 +502,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -627,8 +511,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   
   <span class="md-ellipsis">
@@ -637,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_4">
@@ -648,207 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#docforge.nav" class="md-nav__link">
-    <span class="md-ellipsis">
-      nav
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="nav">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav--navigation-layer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Navigation Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Navigation Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav--workflow" class="md-nav__link">
-    <span class="md-ellipsis">
-      Workflow
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.MkDocsNavEmitter" class="md-nav__link">
-    <span class="md-ellipsis">
-      MkDocsNavEmitter
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="MkDocsNavEmitter">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.MkDocsNavEmitter.emit" class="md-nav__link">
-    <span class="md-ellipsis">
-      emit
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.NavSpec" class="md-nav__link">
-    <span class="md-ellipsis">
-      NavSpec
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="NavSpec">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.NavSpec.all_patterns" class="md-nav__link">
-    <span class="md-ellipsis">
-      all_patterns
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.NavSpec.load" class="md-nav__link">
-    <span class="md-ellipsis">
-      load
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.ResolvedNav" class="md-nav__link">
-    <span class="md-ellipsis">
-      ResolvedNav
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="ResolvedNav">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.ResolvedNav.all_files" class="md-nav__link">
-    <span class="md-ellipsis">
-      all_files
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.load_nav_spec" class="md-nav__link">
-    <span class="md-ellipsis">
-      load_nav_spec
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.nav.resolve_nav" class="md-nav__link">
-    <span class="md-ellipsis">
-      resolve_nav
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
             
               
                 
@@ -934,13 +624,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -949,8 +653,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -959,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -970,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1076,13 +766,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1091,8 +797,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1101,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1112,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1270,16 +962,6 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge.nav--navigation-layer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Navigation Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Navigation Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
   <a href="#docforge.nav--workflow" class="md-nav__link">
     <span class="md-ellipsis">
       Workflow
@@ -1288,10 +970,15 @@
   
 </li>
         
-      </ul>
-    </nav>
+          <li class="md-nav__item">
+  <a href="#docforge.nav-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
   
-</li>
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
         
           <li class="md-nav__item">
   <a href="#docforge.nav.MkDocsNavEmitter" class="md-nav__link">
@@ -1304,6 +991,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.MkDocsNavEmitter-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.MkDocsNavEmitter.emit" class="md-nav__link">
     <span class="md-ellipsis">
       emit
@@ -1315,6 +1012,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1328,6 +1030,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.NavSpec-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.NavSpec.all_patterns" class="md-nav__link">
     <span class="md-ellipsis">
       all_patterns
@@ -1348,6 +1060,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1361,6 +1078,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.ResolvedNav-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.ResolvedNav.all_files" class="md-nav__link">
     <span class="md-ellipsis">
       all_files
@@ -1374,6 +1101,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.nav-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.nav.load_nav_spec" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1395,6 +1142,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1421,24 +1173,30 @@
 
 
 <h2 id="docforge.nav" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.nav</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.nav</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <h3 id="docforge.nav--navigation-layer">Navigation Layer</h3>
-<p>The <code>docforge.nav</code> package manages the mapping between the logical documentation
-structure and the physical files on disk.</p>
+      <p>Navigation layer for doc-forge.</p>
+<p>The <code>docforge.nav</code> package manages the relationship between the logical
+documentation structure defined by the user and the physical documentation
+files generated on disk.</p>
+<hr />
 <h4 id="docforge.nav--workflow">Workflow</h4>
 <ol>
-<li><strong>Spec Definition</strong>: Users define navigation intent in <code>docforge.nav.yml</code>.</li>
-<li><strong>Resolution</strong>: <code>resolve_nav</code> matches patterns in the spec to generated <code>.md</code> files.</li>
-<li><strong>Emission</strong>: <code>MkDocsNavEmitter</code> produces the final YAML structure for <code>mkdocs.yml</code>.</li>
+<li><strong>Specification</strong> – Users define navigation intent in <code>docforge.nav.yml</code>.</li>
+<li><strong>Resolution</strong> – <code>resolve_nav</code> expands patterns and matches them against
+   generated Markdown files.</li>
+<li><strong>Emission</strong> – <code>MkDocsNavEmitter</code> converts the resolved structure into
+   the YAML navigation format required by <code>mkdocs.yml</code>.</li>
 </ol>
-<p>This abstraction allows doc-forge to support complex grouping and ordering
-independently of the source code's physical layout.</p>
+<p>This layer separates documentation organization from the underlying source
+code layout, enabling flexible grouping, ordering, and navigation structures
+independent of module hierarchy.</p>
+<hr />
 
 
 
@@ -1449,24 +1207,25 @@ independently of the source code's physical layout.</p>
 
 
 
-
+<h3 id="docforge.nav-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.nav.MkDocsNavEmitter" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MkDocsNavEmitter</span>
+<h4 id="docforge.nav.MkDocsNavEmitter" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MkDocsNavEmitter</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible
-navigation structure.</p>
+      <p>Emit MkDocs navigation structures from resolved navigation data.</p>
+<p>The emitter transforms a <code>ResolvedNav</code> object into the YAML-compatible
+list structure expected by the MkDocs <code>nav</code> configuration field.</p>
 
 
 
@@ -1479,22 +1238,22 @@ navigation structure.</p>
 
 
 
-
+<h5 id="docforge.nav.MkDocsNavEmitter-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.MkDocsNavEmitter.emit" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">emit</span>
+<h6 id="docforge.nav.MkDocsNavEmitter.emit" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">emit</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">emit</span><span class="p">(</span><span class="n">nav</span><span class="p">:</span> <span class="n">ResolvedNav</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">emit</span><span class="p">(</span><span class="n">nav</span><span class="p">:</span> <span class="n">ResolvedNav</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate a list of navigation entries for mkdocs.yml.</p>
+      <p>Generate a navigation structure for <code>mkdocs.yml</code>.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1515,7 +1274,8 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The resolved navigation data.</p>
+                <p>Resolved navigation data describing documentation groups
+and their associated Markdown files.</p>
               </div>
             </td>
             <td>
@@ -1541,7 +1301,27 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of dictionary mappings representing the MkDocs navigation.</p>
+                <p>A list of dictionaries representing the MkDocs navigation layout.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.List">List</span>[<span title="typing.Dict">Dict</span>[str, <span title="typing.Any">Any</span>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Each dictionary maps a navigation label to a page or a list of</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.List">List</span>[<span title="typing.Dict">Dict</span>[str, <span title="typing.Any">Any</span>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>pages.</p>
               </div>
             </td>
           </tr>
@@ -1564,18 +1344,20 @@ navigation structure.</p>
 
 
 
-<h3 id="docforge.nav.NavSpec" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">NavSpec</span>
+<h4 id="docforge.nav.NavSpec" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">NavSpec</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">NavSpec</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]])</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">NavSpec</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]])</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Parsed representation of the docforge navigation specification file.</p>
+      <p>Parsed representation of a navigation specification.</p>
+<p>A <code>NavSpec</code> describes the intended documentation navigation layout before
+it is resolved against the filesystem.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1595,7 +1377,8 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the home document (e.g., 'index.md').</p>
+                <p>Relative path to the documentation home page (for example
+<code>index.md</code>).</p>
               </div>
             </td>
           </tr>
@@ -1606,14 +1389,15 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Mapping of group titles to lists of path patterns/globs.</p>
+                <p>Mapping of navigation group titles to lists of file patterns
+or glob expressions.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a NavSpec.</p>
+      <p>Initialize a NavSpec instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1634,7 +1418,7 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The path to the home document.</p>
+                <p>Relative path to the home document.</p>
               </div>
             </td>
             <td>
@@ -1648,7 +1432,8 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A mapping of group names to lists of path patterns (globs).</p>
+                <p>Mapping of group names to lists of path patterns
+(glob expressions).</p>
               </div>
             </td>
             <td>
@@ -1669,22 +1454,22 @@ navigation structure.</p>
 
 
 
-
+<h5 id="docforge.nav.NavSpec-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.NavSpec.all_patterns" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">all_patterns</span>
+<h6 id="docforge.nav.NavSpec.all_patterns" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">all_patterns</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">all_patterns</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">all_patterns</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all path patterns referenced in the specification.</p>
+      <p>Return all path patterns referenced by the specification.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1702,7 +1487,17 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of all patterns (home plus all groups).</p>
+                <p>A list containing the home document (if defined) and all</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.List">List</span>[str]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>group pattern entries.</p>
               </div>
             </td>
           </tr>
@@ -1716,21 +1511,21 @@ navigation structure.</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.NavSpec.load" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load</span>
+<h6 id="docforge.nav.NavSpec.load" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load</span>
 
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small>
   </span>
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load a NavSpec from a YAML file.</p>
+      <p>Load a navigation specification from a YAML file.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1751,7 +1546,7 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The filesystem path to the YAML file.</p>
+                <p>Filesystem path to the navigation specification file.</p>
               </div>
             </td>
             <td>
@@ -1777,7 +1572,7 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A NavSpec instance.</p>
+                <p>A <code>NavSpec</code> instance representing the parsed configuration.</p>
               </div>
             </td>
           </tr>
@@ -1800,7 +1595,7 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If the path does not exist.</p>
+                <p>If the specified file does not exist.</p>
               </div>
             </td>
           </tr>
@@ -1810,7 +1605,8 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If the file content is not a valid NavSpec mapping.</p>
+                <p>If the file contents are not a valid navigation
+specification.</p>
               </div>
             </td>
           </tr>
@@ -1833,19 +1629,20 @@ navigation structure.</p>
 
 
 
-<h3 id="docforge.nav.ResolvedNav" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">ResolvedNav</span>
+<h4 id="docforge.nav.ResolvedNav" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">ResolvedNav</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">ResolvedNav</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]],</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">ResolvedNav</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]],</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a navigation structure where all patterns and paths have been
-resolved against the actual filesystem contents.</p>
+      <p>Resolved navigation structure.</p>
+<p>A <code>ResolvedNav</code> represents navigation data after glob patterns have been
+expanded and paths validated against the filesystem.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1865,7 +1662,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Resolved relative path to the home page.</p>
+                <p>Relative path to the documentation home page.</p>
               </div>
             </td>
           </tr>
@@ -1876,7 +1673,8 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Mapping of group titles to lists of absolute or relative Path objects.</p>
+                <p>Mapping of navigation group titles to lists of resolved
+documentation file paths.</p>
               </div>
             </td>
           </tr>
@@ -1904,7 +1702,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The relative path to the project home page.</p>
+                <p>Relative path to the home page within the documentation root.</p>
               </div>
             </td>
             <td>
@@ -1918,7 +1716,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A mapping of group names to their resolved filesystem paths.</p>
+                <p>Mapping of group titles to resolved documentation file paths.</p>
               </div>
             </td>
             <td>
@@ -1932,7 +1730,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root documentation directory.</p>
+                <p>Root directory of the documentation source files.</p>
               </div>
             </td>
             <td>
@@ -1953,22 +1751,22 @@ resolved against the actual filesystem contents.</p>
 
 
 
-
+<h5 id="docforge.nav.ResolvedNav-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.ResolvedNav.all_files" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">all_files</span>
+<h6 id="docforge.nav.ResolvedNav.all_files" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">all_files</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">all_files</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Path</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">all_files</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Path</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get an iterable of all resolved files in the navigation structure.</p>
+      <p>Iterate over all files referenced by the navigation structure.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1986,7 +1784,31 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of Path objects.</p>
+                <p>An iterable of <code>Path</code> objects representing documentation files.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>RuntimeError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the home page is defined but the documentation
+root is not available for resolution.</p>
               </div>
             </td>
           </tr>
@@ -2004,22 +1826,24 @@ resolved against the actual filesystem contents.</p>
     </div>
 
 </div>
-
+<h3 id="docforge.nav-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.nav.load_nav_spec" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_nav_spec</span>
+<h4 id="docforge.nav.load_nav_spec" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">load_nav_spec</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_nav_spec</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_nav_spec</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Utility function to load a NavSpec from a file.</p>
+      <p>Load a navigation specification file.</p>
+<p>This helper function reads a YAML navigation file and constructs a
+corresponding <code>NavSpec</code> instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2066,7 +1890,40 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A loaded NavSpec instance.</p>
+                <p>A <code>NavSpec</code> instance representing the parsed specification.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>FileNotFoundError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the specification file does not exist.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ValueError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the YAML structure is invalid.</p>
               </div>
             </td>
           </tr>
@@ -2080,18 +1937,19 @@ resolved against the actual filesystem contents.</p>
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.nav.resolve_nav" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">resolve_nav</span>
+<h4 id="docforge.nav.resolve_nav" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">resolve_nav</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">resolve_nav</span><span class="p">(</span><span class="n">spec</span><span class="p">:</span> <span class="n">NavSpec</span><span class="p">,</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ResolvedNav</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">resolve_nav</span><span class="p">(</span><span class="n">spec</span><span class="p">:</span> <span class="n">NavSpec</span><span class="p">,</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ResolvedNav</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Create a ResolvedNav by processing a NavSpec against the filesystem.
-This expands globs and validates the existence of referenced files.</p>
+      <p>Resolve a navigation specification against the filesystem.</p>
+<p>The function expands glob patterns defined in a <code>NavSpec</code> and verifies
+that referenced documentation files exist within the documentation root.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -2112,7 +1970,7 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The navigation specification to resolve.</p>
+                <p>Navigation specification describing documentation layout.</p>
               </div>
             </td>
             <td>
@@ -2126,7 +1984,7 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root directory for documentation files.</p>
+                <p>Root directory containing documentation Markdown files.</p>
               </div>
             </td>
             <td>
@@ -2152,7 +2010,7 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A ResolvedNav instance.</p>
+                <p>A <code>ResolvedNav</code> instance containing validated navigation paths.</p>
               </div>
             </td>
           </tr>
@@ -2175,7 +2033,8 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If a pattern doesn't match any files or the docs_root doesn't exist.</p>
+                <p>If the documentation root does not exist or a
+navigation pattern does not match any files.</p>
               </div>
             </td>
           </tr>
@@ -2210,6 +2069,8 @@ This expands globs and validates the existence of referenced files.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -2247,7 +2108,7 @@ This expands globs and validates the existence of referenced files.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/nav/mkdocs/index.html b/libs/doc-forge/site/nav/mkdocs/index.html
index 2f3e200..1699245 100644
--- a/libs/doc-forge/site/nav/mkdocs/index.html
+++ b/libs/doc-forge/site/nav/mkdocs/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -610,6 +483,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -617,7 +502,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -627,8 +511,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -637,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_4">
@@ -648,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -783,6 +653,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.mkdocs-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.mkdocs.MkDocsNavEmitter" class="md-nav__link">
     <span class="md-ellipsis">
       MkDocsNavEmitter
@@ -793,6 +673,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.mkdocs.MkDocsNavEmitter-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.mkdocs.MkDocsNavEmitter.emit" class="md-nav__link">
     <span class="md-ellipsis">
       emit
@@ -809,6 +699,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -835,13 +735,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -850,8 +764,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -860,8 +775,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -871,27 +792,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -977,13 +877,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -992,8 +908,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1002,8 +919,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1013,27 +936,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1171,6 +1073,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.mkdocs-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.mkdocs.MkDocsNavEmitter" class="md-nav__link">
     <span class="md-ellipsis">
       MkDocsNavEmitter
@@ -1181,6 +1093,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.mkdocs.MkDocsNavEmitter-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.mkdocs.MkDocsNavEmitter.emit" class="md-nav__link">
     <span class="md-ellipsis">
       emit
@@ -1197,6 +1119,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1223,16 +1155,17 @@
 
 
 <h2 id="docforge.nav.mkdocs" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.nav.mkdocs</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.nav.mkdocs</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module provides the MkDocsNavEmitter, which converts a ResolvedNav instance
-into the specific YAML-ready list structure expected by the MkDocs 'nav'
-configuration.</p>
+      <p>MkDocs navigation emitter.</p>
+<p>This module provides the <code>MkDocsNavEmitter</code> class, which converts a
+<code>ResolvedNav</code> instance into the navigation structure required by the
+MkDocs <code>nav</code> configuration.</p>
 
 
 
@@ -1243,24 +1176,25 @@ configuration.</p>
 
 
 
-
+<h3 id="docforge.nav.mkdocs-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.nav.mkdocs.MkDocsNavEmitter" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MkDocsNavEmitter</span>
+<h4 id="docforge.nav.mkdocs.MkDocsNavEmitter" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MkDocsNavEmitter</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible
-navigation structure.</p>
+      <p>Emit MkDocs navigation structures from resolved navigation data.</p>
+<p>The emitter transforms a <code>ResolvedNav</code> object into the YAML-compatible
+list structure expected by the MkDocs <code>nav</code> configuration field.</p>
 
 
 
@@ -1273,22 +1207,22 @@ navigation structure.</p>
 
 
 
-
+<h5 id="docforge.nav.mkdocs.MkDocsNavEmitter-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.mkdocs.MkDocsNavEmitter.emit" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">emit</span>
+<h6 id="docforge.nav.mkdocs.MkDocsNavEmitter.emit" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">emit</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">emit</span><span class="p">(</span><span class="n">nav</span><span class="p">:</span> <span class="n">ResolvedNav</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">emit</span><span class="p">(</span><span class="n">nav</span><span class="p">:</span> <span class="n">ResolvedNav</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">Any</span><span class="p">]]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate a list of navigation entries for mkdocs.yml.</p>
+      <p>Generate a navigation structure for <code>mkdocs.yml</code>.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1309,7 +1243,8 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The resolved navigation data.</p>
+                <p>Resolved navigation data describing documentation groups
+and their associated Markdown files.</p>
               </div>
             </td>
             <td>
@@ -1335,7 +1270,27 @@ navigation structure.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of dictionary mappings representing the MkDocs navigation.</p>
+                <p>A list of dictionaries representing the MkDocs navigation layout.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.List">List</span>[<span title="typing.Dict">Dict</span>[str, <span title="typing.Any">Any</span>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Each dictionary maps a navigation label to a page or a list of</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.List">List</span>[<span title="typing.Dict">Dict</span>[str, <span title="typing.Any">Any</span>]]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>pages.</p>
               </div>
             </td>
           </tr>
@@ -1379,6 +1334,8 @@ navigation structure.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1416,7 +1373,7 @@ navigation structure.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/nav/resolver/index.html b/libs/doc-forge/site/nav/resolver/index.html
index 3771b10..9994b08 100644
--- a/libs/doc-forge/site/nav/resolver/index.html
+++ b/libs/doc-forge/site/nav/resolver/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -610,6 +483,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -617,7 +502,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -627,8 +511,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -637,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_4">
@@ -648,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -760,6 +630,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.resolver-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.resolver.ResolvedNav" class="md-nav__link">
     <span class="md-ellipsis">
       ResolvedNav
@@ -770,6 +650,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.resolver.ResolvedNav-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.resolver.ResolvedNav.all_files" class="md-nav__link">
     <span class="md-ellipsis">
       all_files
@@ -783,6 +673,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.nav.resolver-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.nav.resolver.resolve_nav" class="md-nav__link">
     <span class="md-ellipsis">
@@ -795,6 +705,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -844,13 +759,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -859,8 +788,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -869,8 +799,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -880,27 +816,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -986,13 +901,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1001,8 +932,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1011,8 +943,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1022,27 +960,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1180,6 +1097,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.resolver-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.resolver.ResolvedNav" class="md-nav__link">
     <span class="md-ellipsis">
       ResolvedNav
@@ -1190,6 +1117,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.resolver.ResolvedNav-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.resolver.ResolvedNav.all_files" class="md-nav__link">
     <span class="md-ellipsis">
       all_files
@@ -1203,6 +1140,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.nav.resolver-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.nav.resolver.resolve_nav" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1215,6 +1172,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1241,16 +1203,16 @@
 
 
 <h2 id="docforge.nav.resolver" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.nav.resolver</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.nav.resolver</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module contains the logic for resolving a NavSpec against the physical
-filesystem. It expands globs and validates that all referenced documents
-actually exist on disk.</p>
+      <p>Navigation resolution utilities.</p>
+<p>This module resolves a <code>NavSpec</code> against the filesystem by expanding glob
+patterns and validating that referenced documentation files exist.</p>
 
 
 
@@ -1261,25 +1223,26 @@ actually exist on disk.</p>
 
 
 
-
+<h3 id="docforge.nav.resolver-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.nav.resolver.ResolvedNav" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">ResolvedNav</span>
+<h4 id="docforge.nav.resolver.ResolvedNav" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">ResolvedNav</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">ResolvedNav</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]],</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">ResolvedNav</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="nb">str</span> <span class="o">|</span> <span class="kc">None</span><span class="p">,</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="n">Path</span><span class="p">]],</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Represents a navigation structure where all patterns and paths have been
-resolved against the actual filesystem contents.</p>
+      <p>Resolved navigation structure.</p>
+<p>A <code>ResolvedNav</code> represents navigation data after glob patterns have been
+expanded and paths validated against the filesystem.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1299,7 +1262,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Resolved relative path to the home page.</p>
+                <p>Relative path to the documentation home page.</p>
               </div>
             </td>
           </tr>
@@ -1310,7 +1273,8 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Mapping of group titles to lists of absolute or relative Path objects.</p>
+                <p>Mapping of navigation group titles to lists of resolved
+documentation file paths.</p>
               </div>
             </td>
           </tr>
@@ -1338,7 +1302,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The relative path to the project home page.</p>
+                <p>Relative path to the home page within the documentation root.</p>
               </div>
             </td>
             <td>
@@ -1352,7 +1316,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A mapping of group names to their resolved filesystem paths.</p>
+                <p>Mapping of group titles to resolved documentation file paths.</p>
               </div>
             </td>
             <td>
@@ -1366,7 +1330,7 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root documentation directory.</p>
+                <p>Root directory of the documentation source files.</p>
               </div>
             </td>
             <td>
@@ -1387,22 +1351,22 @@ resolved against the actual filesystem contents.</p>
 
 
 
-
+<h5 id="docforge.nav.resolver.ResolvedNav-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.resolver.ResolvedNav.all_files" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">all_files</span>
+<h6 id="docforge.nav.resolver.ResolvedNav.all_files" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">all_files</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">all_files</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Path</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">all_files</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Iterable</span><span class="p">[</span><span class="n">Path</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get an iterable of all resolved files in the navigation structure.</p>
+      <p>Iterate over all files referenced by the navigation structure.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1420,7 +1384,31 @@ resolved against the actual filesystem contents.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>An iterable of Path objects.</p>
+                <p>An iterable of <code>Path</code> objects representing documentation files.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>RuntimeError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the home page is defined but the documentation
+root is not available for resolution.</p>
               </div>
             </td>
           </tr>
@@ -1438,23 +1426,24 @@ resolved against the actual filesystem contents.</p>
     </div>
 
 </div>
-
+<h3 id="docforge.nav.resolver-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.nav.resolver.resolve_nav" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">resolve_nav</span>
+<h4 id="docforge.nav.resolver.resolve_nav" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">resolve_nav</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">resolve_nav</span><span class="p">(</span><span class="n">spec</span><span class="p">:</span> <span class="n">NavSpec</span><span class="p">,</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ResolvedNav</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">resolve_nav</span><span class="p">(</span><span class="n">spec</span><span class="p">:</span> <span class="n">NavSpec</span><span class="p">,</span> <span class="n">docs_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">ResolvedNav</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Create a ResolvedNav by processing a NavSpec against the filesystem.
-This expands globs and validates the existence of referenced files.</p>
+      <p>Resolve a navigation specification against the filesystem.</p>
+<p>The function expands glob patterns defined in a <code>NavSpec</code> and verifies
+that referenced documentation files exist within the documentation root.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1475,7 +1464,7 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The navigation specification to resolve.</p>
+                <p>Navigation specification describing documentation layout.</p>
               </div>
             </td>
             <td>
@@ -1489,7 +1478,7 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The root directory for documentation files.</p>
+                <p>Root directory containing documentation Markdown files.</p>
               </div>
             </td>
             <td>
@@ -1515,7 +1504,7 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A ResolvedNav instance.</p>
+                <p>A <code>ResolvedNav</code> instance containing validated navigation paths.</p>
               </div>
             </td>
           </tr>
@@ -1538,7 +1527,8 @@ This expands globs and validates the existence of referenced files.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If a pattern doesn't match any files or the docs_root doesn't exist.</p>
+                <p>If the documentation root does not exist or a
+navigation pattern does not match any files.</p>
               </div>
             </td>
           </tr>
@@ -1573,6 +1563,8 @@ This expands globs and validates the existence of referenced files.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1610,7 +1602,7 @@ This expands globs and validates the existence of referenced files.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/nav/spec/index.html b/libs/doc-forge/site/nav/spec/index.html
index 76aa0db..de70b48 100644
--- a/libs/doc-forge/site/nav/spec/index.html
+++ b/libs/doc-forge/site/nav/spec/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -610,6 +483,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -617,7 +502,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -627,8 +511,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_4" checked>
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -637,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_4">
@@ -648,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -737,6 +607,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.spec-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.spec.NavSpec" class="md-nav__link">
     <span class="md-ellipsis">
       NavSpec
@@ -747,6 +627,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.spec.NavSpec-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.spec.NavSpec.all_patterns" class="md-nav__link">
     <span class="md-ellipsis">
       all_patterns
@@ -769,6 +659,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.nav.spec-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.nav.spec.load_nav_spec" class="md-nav__link">
     <span class="md-ellipsis">
@@ -781,6 +691,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -853,13 +768,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -868,8 +797,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -878,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -889,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -995,13 +910,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1010,8 +941,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1020,8 +952,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1031,27 +969,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1189,6 +1106,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.spec-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.spec.NavSpec" class="md-nav__link">
     <span class="md-ellipsis">
       NavSpec
@@ -1199,6 +1126,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.nav.spec.NavSpec-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.nav.spec.NavSpec.all_patterns" class="md-nav__link">
     <span class="md-ellipsis">
       all_patterns
@@ -1221,6 +1158,26 @@
   
 </li>
         
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+          <li class="md-nav__item">
+  <a href="#docforge.nav.spec-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
           <li class="md-nav__item">
   <a href="#docforge.nav.spec.load_nav_spec" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1233,6 +1190,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1259,16 +1221,17 @@
 
 
 <h2 id="docforge.nav.spec" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.nav.spec</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.nav.spec</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module defines the NavSpec class, which represents the user's intent for
-documentation navigation as defined in a YAML specification (usually
-docforge.nav.yml).</p>
+      <p>Navigation specification model.</p>
+<p>This module defines the <code>NavSpec</code> class, which represents the navigation
+structure defined by the user in the doc-forge navigation specification
+(typically <code>docforge.nav.yml</code>).</p>
 
 
 
@@ -1279,24 +1242,26 @@ docforge.nav.yml).</p>
 
 
 
-
+<h3 id="docforge.nav.spec-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.nav.spec.NavSpec" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">NavSpec</span>
+<h4 id="docforge.nav.spec.NavSpec" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">NavSpec</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">NavSpec</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]])</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">NavSpec</span><span class="p">(</span><span class="n">home</span><span class="p">:</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">],</span> <span class="n">groups</span><span class="p">:</span> <span class="n">Dict</span><span class="p">[</span><span class="nb">str</span><span class="p">,</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]])</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>Parsed representation of the docforge navigation specification file.</p>
+      <p>Parsed representation of a navigation specification.</p>
+<p>A <code>NavSpec</code> describes the intended documentation navigation layout before
+it is resolved against the filesystem.</p>
 
 
 <p><span class="doc-section-title">Attributes:</span></p>
@@ -1316,7 +1281,8 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the home document (e.g., 'index.md').</p>
+                <p>Relative path to the documentation home page (for example
+<code>index.md</code>).</p>
               </div>
             </td>
           </tr>
@@ -1327,14 +1293,15 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Mapping of group titles to lists of path patterns/globs.</p>
+                <p>Mapping of navigation group titles to lists of file patterns
+or glob expressions.</p>
               </div>
             </td>
           </tr>
       </tbody>
     </table>
 
-      <p>Initialize a NavSpec.</p>
+      <p>Initialize a NavSpec instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1355,7 +1322,7 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The path to the home document.</p>
+                <p>Relative path to the home document.</p>
               </div>
             </td>
             <td>
@@ -1369,7 +1336,8 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A mapping of group names to lists of path patterns (globs).</p>
+                <p>Mapping of group names to lists of path patterns
+(glob expressions).</p>
               </div>
             </td>
             <td>
@@ -1390,22 +1358,22 @@ docforge.nav.yml).</p>
 
 
 
-
+<h5 id="docforge.nav.spec.NavSpec-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.spec.NavSpec.all_patterns" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">all_patterns</span>
+<h6 id="docforge.nav.spec.NavSpec.all_patterns" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">all_patterns</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">all_patterns</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">all_patterns</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">List</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Get all path patterns referenced in the specification.</p>
+      <p>Return all path patterns referenced by the specification.</p>
 
 
     <p><span class="doc-section-title">Returns:</span></p>
@@ -1423,7 +1391,17 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A list of all patterns (home plus all groups).</p>
+                <p>A list containing the home document (if defined) and all</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code><span title="typing.List">List</span>[str]</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>group pattern entries.</p>
               </div>
             </td>
           </tr>
@@ -1437,21 +1415,21 @@ docforge.nav.yml).</p>
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.nav.spec.NavSpec.load" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load</span>
+<h6 id="docforge.nav.spec.NavSpec.load" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">load</span>
 
 
   <span class="doc doc-labels">
       <small class="doc doc-label doc-label-classmethod"><code>classmethod</code></small>
   </span>
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Load a NavSpec from a YAML file.</p>
+      <p>Load a navigation specification from a YAML file.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1472,7 +1450,7 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The filesystem path to the YAML file.</p>
+                <p>Filesystem path to the navigation specification file.</p>
               </div>
             </td>
             <td>
@@ -1498,7 +1476,7 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A NavSpec instance.</p>
+                <p>A <code>NavSpec</code> instance representing the parsed configuration.</p>
               </div>
             </td>
           </tr>
@@ -1521,7 +1499,7 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If the path does not exist.</p>
+                <p>If the specified file does not exist.</p>
               </div>
             </td>
           </tr>
@@ -1531,7 +1509,8 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>If the file content is not a valid NavSpec mapping.</p>
+                <p>If the file contents are not a valid navigation
+specification.</p>
               </div>
             </td>
           </tr>
@@ -1549,22 +1528,24 @@ docforge.nav.yml).</p>
     </div>
 
 </div>
-
+<h3 id="docforge.nav.spec-functions">Functions</h3>
 
 <div class="doc doc-object doc-function">
 
 
-<h3 id="docforge.nav.spec.load_nav_spec" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">load_nav_spec</span>
+<h4 id="docforge.nav.spec.load_nav_spec" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-function"></code>            <span class="doc doc-object-name doc-function-name">load_nav_spec</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">load_nav_spec</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">load_nav_spec</span><span class="p">(</span><span class="n">path</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="n">NavSpec</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Utility function to load a NavSpec from a file.</p>
+      <p>Load a navigation specification file.</p>
+<p>This helper function reads a YAML navigation file and constructs a
+corresponding <code>NavSpec</code> instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1611,7 +1592,40 @@ docforge.nav.yml).</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>A loaded NavSpec instance.</p>
+                <p>A <code>NavSpec</code> instance representing the parsed specification.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+
+<p><span class="doc-section-title">Raises:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td>
+                  <code>FileNotFoundError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the specification file does not exist.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td>
+                  <code>ValueError</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If the YAML structure is invalid.</p>
               </div>
             </td>
           </tr>
@@ -1646,6 +1660,8 @@ docforge.nav.yml).</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1683,7 +1699,7 @@ docforge.nav.yml).</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/objects.inv b/libs/doc-forge/site/objects.inv
index 1d5709b92bfadbb1e9ce32583974b577c307abeb..b5d05fb6bbdd7df5801af73d25feb8fe35bc693f 100644
GIT binary patch
delta 1021
zcmV<Z0|NZo2<!-ueSb}F+b|5h?^gs^uk+9xckPB<)~;xOfZ^Cm=GGs9<pkKjpKQsp
zzDQASuu~BEy+?|qXvwPj^4Je2wmbj**7nt<VY~a?=eymPPnCL-{T%A!k^Sn6iVYL2
zYzod%RMv=}T*(Q>@zRxJ-FF1idFbC*Iijq`hvyg82@2+q0e{L)tYbqlvYhvqp=2Ca
zfB)W>oM6Dhtu_W$R4q#|k>+06)K;#<|F0e*EBm%Bx{7<y<pIJ0629Lx^N65oni{bg
zknG`7H<dFts!MHo&M#x#m=oI1Z2iP=Yoe|UQ1e}kb4b>B=qj5$NSw3b$~I1R99SZ?
zE$Yro^)v`zHGjb|0Z{_czjvb#vu<2at8TCn?0172Gllh-MZ%O{rwm%Ub51Q)HDbU)
z#j56IFA%CN=I3JkW3O~99$_|U%xFg8o<h$ZRLCehyt3{CD+}e`x^PTs*@K^o>yNe`
zM_axtu7<Su=cD7&8!FT0VJ4tnniAaqQIV!SU6f_t9e?Z72fdHHG*ji~&4<Wz&d;oL
zg5Z~fjmC7R1=w8K1dghjSWFXKlJI=vxpwy%D$myP)zuI}g8M`|3)wfOiiG!(xC$jm
zxWZ}nBX4vJywF()ib^JW!tcW}m!**iU1n`e<bVN=>c-NQ?rCBwZ(#sWbGn5`?Qks8
z3K>;=UVlA|NiNW+W=f%AF>tnxdt(piZ!b;W?5|bd%bf0fT&RMHgsiAU5wZ3lOVpSi
zjecTdUNnu8;F~p)U2yA&f}SVa9|HAE;4U+je7;Q}*|=BSB)H6Ks5MZ?I;XP$->C2*
z^J>{OHBSlFYSLXb@;}Bx-vTmiem{}p;dg?q4u6&_!82m<(v?W1oF=!`v6bhhY>7F{
zLfc*nJ=z45#7HeMS#hg-#{1iiuzG~@kOq`Ok2a(vF;as{R=lZu(FPV)REHRysrd-w
zB9N0cm60*=>o^u>3eKxKu;C^YFq;x1woAfD$5SlKJ24XBMV{iSCmAf<EdxBecC7u1
z34b%;11rRk$3riHau~!%)0xVLk{i<r##J7p)xmiPpQi_l>WD+<b0~<5rWeN52aw}e
zt8{<LpyT>9q~VYpQfU-#sI^DY!o!FtEY)kpQU)Z5g;qR)5?lKe37`vL)Yw7|aP=oa
zD>BB%!!R1U7)v6?KCBVMzzeigZsbyJyLQ~xsT~T=fSgQ^P~Nm-!h@0|L7z-qcF}y$
zA7&Gsn=S(eV{U=?m=KaqyqZ5GNsk}RjQsW*3xbWJs*#q|ZM4Zt?$+j_SwQWni#RLn
r`noQJ4BhaNDcNvwZ%=XNR6<-^^E_N1NBOwln}m?rxO)EpB-}#Mtic52

delta 1003
zcmV<H0~Gx12-*mceSgc2+b|5g_bUQ)uXV9G_PQ;4>24RhA7D7PlDhRHu$%z>`^uIq
z>qUxkf}Vm%Gee4`Xvwbn^4Je2wmbj*()QJ*VY|oO$A{gg50#q9z7O^B$bR%i#fAx1
zHU;M>Dr>|~uH*#cc<IWq?mGhMJoLX=IijrRr`I>u2@2+q0e{L)tYbqlvYhvqp=2Ca
z|MRskIl+L1OS4fnwH0vj|Feh4%D!!juHqhanLs!|*7mz*9uZVcQzJG5l097NrgGLs
zb*U}S`DLsdb3yx=t!E6kChE!nHUEfl4#^smuCmF4#5o(TY~y0bfhAJgqVBv@PlEtf
z6C4u|B@q2bH-Gvt>&^wW>IQf7emAHwQ&^8#Bux2z%Aln?=hRYFBL*B)tZH8N0-<_a
zelEse_D;v*5oUwNbVnIjxTnx_2Ng2P4)3hTz|KOs_bwb$TK3?V;`*(v$I+JWimM?l
z{`u&*^oGi`d6)^Pm!<^we^jJtPZwp`cgOm4qxX@AW`C;Oe1Z^}&iR>@P7wTZu+f<A
zv;mtdo4`?36N_nrTM}MxJlF0yL*?1pzPcJhNbs;nXCa5bRFUvu5LclD30FAHe&mgg
zffqUpK~c#>PxyIQ*0MAbq06j;i5xJ%QQcU&(mhQ~<vk4GX->EBtR0R;S|Ou~ud9bK
z$psqKOn)g<EC$Z8ac`Uf{o|#{oBg%wds)+ij|){Wk&qRYC?eJ#WQiKfqtQ=n%!{T`
z5`42pvI}k<QPA^Z`$M3f3EX9+lFzpZBpdgNn*^6x4YdXeS?6>X;2RZgGOxB>Q}dKy
zttQ=FBmZM8^eG_I=Jyjh9)2d+>R`DNJR=q_U4MyG%4u?29b0*B%9fbJEVS*V(4$Q-
zNsQDIlNGnRXFR{%2&*ZShcuuRdbA-WiIEyqvf^Fci#D*ZqPoQBOwCsq7lGWYsf>(?
zU&pa9Q*hqZg$*~MfZ3E7aa<BcI-X)-K8cYCZ}Jvby~tqUZW-X&wPWp9OqdB@SRsbI
z9)EfXl*1rCn$A={l-!t3Fs||%tuD?(_&z;YR7V`TpF=@hG`%pcK7bs*TBZ9_1|8R@
zAq|J*kV>O?L#;iE79K`KVX0m#mNFngEVSbZl-S;<NB~^`qsBIBfU92#T9Gkc9){7-
z*R3RC?8O>E4Ezd~%Dvr}L%|sk#AyoUO=L$Ld=*I&^u@$w7tJUACN<Hy>FxbstSt~9
z6GGC7m)}j2^!U-t$d{$DAlN9X8fg#QM>`=bs6F*5%Zh{k;1xoKzLAkB*>G{cKjO?O
Zr(9d}JY1)veBAF%Lda@dy?;j<=TBwj@R<Mr

diff --git a/libs/doc-forge/site/renderers/base/index.html b/libs/doc-forge/site/renderers/base/index.html
index f6529a9..5edcf98 100644
--- a/libs/doc-forge/site/renderers/base/index.html
+++ b/libs/doc-forge/site/renderers/base/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -752,6 +625,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -759,7 +644,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -769,8 +653,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -779,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5">
@@ -790,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -879,6 +749,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.base-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.base.DocRenderer" class="md-nav__link">
     <span class="md-ellipsis">
       DocRenderer
@@ -889,6 +769,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.base.DocRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.base.DocRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -900,6 +790,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -909,6 +804,26 @@
     </span>
   </a>
   
+    <nav class="md-nav" aria-label="RendererConfig">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.base.RendererConfig-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
       </ul>
@@ -986,13 +901,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1001,8 +932,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1011,8 +943,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1022,27 +960,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1180,6 +1097,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.base-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.base.DocRenderer" class="md-nav__link">
     <span class="md-ellipsis">
       DocRenderer
@@ -1190,6 +1117,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.base.DocRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.base.DocRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -1201,6 +1138,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1210,6 +1152,26 @@
     </span>
   </a>
   
+    <nav class="md-nav" aria-label="RendererConfig">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.base.RendererConfig-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
       </ul>
@@ -1241,16 +1203,17 @@
 
 
 <h2 id="docforge.renderers.base" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.renderers.base</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.renderers.base</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>This module defines the base interfaces and configuration containers for
-doc-forge renderers. All renderer implementations should adhere to the
-DocRenderer protocol.</p>
+      <p>Renderer base interfaces and configuration models.</p>
+<p>This module defines the base protocol and configuration container used by
+doc-forge renderers. Concrete renderer implementations should implement the
+<code>DocRenderer</code> protocol.</p>
 
 
 
@@ -1261,17 +1224,17 @@ DocRenderer protocol.</p>
 
 
 
-
+<h3 id="docforge.renderers.base-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.renderers.base.DocRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">DocRenderer</span>
+<h4 id="docforge.renderers.base.DocRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">DocRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
@@ -1280,6 +1243,8 @@ DocRenderer protocol.</p>
 
 
       <p>Protocol defining the interface for documentation renderers.</p>
+<p>Implementations of this protocol are responsible for transforming a
+<code>Project</code> model into renderer-specific documentation sources.</p>
 
 
 
@@ -1292,22 +1257,22 @@ DocRenderer protocol.</p>
 
 
 
-
+<h5 id="docforge.renderers.base.DocRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.renderers.base.DocRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.renderers.base.DocRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate renderer-specific source files for the given project.</p>
+      <p>Generate renderer-specific documentation sources.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1328,7 +1293,7 @@ DocRenderer protocol.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project models containing modules and objects.</p>
+                <p>Project model containing modules and documentation objects.</p>
               </div>
             </td>
             <td>
@@ -1342,7 +1307,8 @@ DocRenderer protocol.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for the generated files.</p>
+                <p>Directory where generated documentation sources
+should be written.</p>
               </div>
             </td>
             <td>
@@ -1368,18 +1334,58 @@ DocRenderer protocol.</p>
 
 
 
-<h3 id="docforge.renderers.base.RendererConfig" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">RendererConfig</span>
+<h4 id="docforge.renderers.base.RendererConfig" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">RendererConfig</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">RendererConfig</span><span class="p">(</span><span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">RendererConfig</span><span class="p">(</span><span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
       <p>Configuration container for documentation renderers.</p>
+<p>A <code>RendererConfig</code> instance groups together the project model and the
+output directory used during rendering.</p>
+
+
+<p><span class="doc-section-title">Attributes:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code><span title="docforge.renderers.base.RendererConfig.out_dir">out_dir</span></code></td>
+            <td>
+                  <code><span title="pathlib.Path">Path</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Directory where generated documentation files will be written.</p>
+              </div>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code><span title="docforge.renderers.base.RendererConfig.project">project</span></code></td>
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="docforge.models.Project" href="../../models/#docforge.models.Project">Project</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Documentation project model to be rendered.</p>
+              </div>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+      <p>Initialize a RendererConfig instance.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1400,7 +1406,7 @@ DocRenderer protocol.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The directory where documentation files should be written.</p>
+                <p>Target directory where documentation files should be written.</p>
               </div>
             </td>
             <td>
@@ -1414,7 +1420,7 @@ DocRenderer protocol.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The introspected project models to be rendered.</p>
+                <p>Introspected project model to render.</p>
               </div>
             </td>
             <td>
@@ -1435,7 +1441,7 @@ DocRenderer protocol.</p>
 
 
 
-
+<h5 id="docforge.renderers.base.RendererConfig-functions">Functions</h5>
 
 
 
@@ -1470,6 +1476,8 @@ DocRenderer protocol.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1507,7 +1515,7 @@ DocRenderer protocol.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/renderers/index.html b/libs/doc-forge/site/renderers/index.html
index 85596af..9ef4897 100644
--- a/libs/doc-forge/site/renderers/index.html
+++ b/libs/doc-forge/site/renderers/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href=".." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href=".." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="./" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href=".." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -752,6 +625,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -759,7 +644,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -769,8 +653,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="./" class="md-nav__link md-nav__link--active">
+              
   
   
   <span class="md-ellipsis">
@@ -779,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link md-nav__link--active" for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5">
@@ -790,165 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-    
-  
-  
-  
-    <li class="md-nav__item md-nav__item--active">
-      
-      <input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">
-      
-      
-        
-      
-      
-        <label class="md-nav__link md-nav__link--active" for="__toc">
-          
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-          <span class="md-nav__icon md-icon"></span>
-        </label>
-      
-      <a href="./" class="md-nav__link md-nav__link--active">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-      
-        
-
-<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
-  
-  
-  
-    
-  
-  
-    <label class="md-nav__title" for="__toc">
-      <span class="md-nav__icon md-icon"></span>
-      Table of contents
-    </label>
-    <ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
-      
-        <li class="md-nav__item">
-  <a href="#docforge.renderers" class="md-nav__link">
-    <span class="md-ellipsis">
-      renderers
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="renderers">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers--renderers-layer" class="md-nav__link">
-    <span class="md-ellipsis">
-      Renderers Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Renderers Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers--current-implementations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Current Implementations
-    </span>
-  </a>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers--extending" class="md-nav__link">
-    <span class="md-ellipsis">
-      Extending
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers.MCPRenderer" class="md-nav__link">
-    <span class="md-ellipsis">
-      MCPRenderer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="MCPRenderer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers.MCPRenderer.generate_sources" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate_sources
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers.MkDocsRenderer" class="md-nav__link">
-    <span class="md-ellipsis">
-      MkDocsRenderer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="MkDocsRenderer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers.MkDocsRenderer.generate_sources" class="md-nav__link">
-    <span class="md-ellipsis">
-      generate_sources
-    </span>
-  </a>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-        
-      </ul>
-    </nav>
-  
-</li>
-      
-    </ul>
-  
-</nav>
-      
-    </li>
-  
-
-              
             
               
                 
@@ -1034,13 +766,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -1049,8 +797,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1059,8 +808,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1070,27 +825,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1228,19 +962,9 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
-  <a href="#docforge.renderers--renderers-layer" class="md-nav__link">
+  <a href="#docforge.renderers--overview" class="md-nav__link">
     <span class="md-ellipsis">
-      Renderers Layer
-    </span>
-  </a>
-  
-    <nav class="md-nav" aria-label="Renderers Layer">
-      <ul class="md-nav__list">
-        
-          <li class="md-nav__item">
-  <a href="#docforge.renderers--current-implementations" class="md-nav__link">
-    <span class="md-ellipsis">
-      Current Implementations
+      Overview
     </span>
   </a>
   
@@ -1255,10 +979,15 @@
   
 </li>
         
-      </ul>
-    </nav>
+          <li class="md-nav__item">
+  <a href="#docforge.renderers-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
   
-</li>
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
         
           <li class="md-nav__item">
   <a href="#docforge.renderers.MCPRenderer" class="md-nav__link">
@@ -1271,6 +1000,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.MCPRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.MCPRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -1282,6 +1021,11 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
         
           <li class="md-nav__item">
@@ -1294,6 +1038,25 @@
     <nav class="md-nav" aria-label="MkDocsRenderer">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.MkDocsRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.MkDocsRenderer.generate_readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      generate_readme
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#docforge.renderers.MkDocsRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1311,6 +1074,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1337,26 +1110,33 @@
 
 
 <h2 id="docforge.renderers" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.renderers</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.renderers</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <h3 id="docforge.renderers--renderers-layer">Renderers Layer</h3>
-<p>The <code>docforge.renderers</code> package handles the transformation of the internal
-documentation models into physical files formatted for specific documentation
-engines.</p>
-<h4 id="docforge.renderers--current-implementations">Current Implementations</h4>
+      <p>Renderers layer for doc-forge.</p>
+<p>The <code>docforge.renderers</code> package transforms the internal documentation
+models into files formatted for specific documentation systems.</p>
+<hr />
+<h4 id="docforge.renderers--overview">Overview</h4>
+<p>Renderers consume the doc-forge project model and generate output suitable
+for documentation tools or machine interfaces.</p>
+<p>Current implementations:</p>
 <ul>
-<li><strong>MkDocsRenderer</strong>: Generates Markdown files utilizing the <code>mkdocstrings</code>
-  syntax. It automatically handles package/module hierarchy and generates
-  <code>index.md</code> files for packages.</li>
+<li><strong>MkDocsRenderer</strong> – Produces Markdown files compatible with MkDocs and
+  the <code>mkdocstrings</code> plugin. It automatically handles package hierarchy
+  and generates <code>index.md</code> files for packages.</li>
+<li><strong>MCPRenderer</strong> – Emits structured JSON resources designed for consumption
+  by Model Context Protocol (MCP) clients.</li>
 </ul>
+<hr />
 <h4 id="docforge.renderers--extending">Extending</h4>
-<p>To add a new renderer, implement the <code>DocRenderer</code> protocol defined in
-<code>docforge.renderers.base</code>.</p>
+<p>New renderers can be added by implementing the <code>DocRenderer</code> protocol
+defined in <code>docforge.renderers.base</code>.</p>
+<hr />
 
 
 
@@ -1367,23 +1147,26 @@ engines.</p>
 
 
 
-
+<h3 id="docforge.renderers-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.renderers.MCPRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MCPRenderer</span>
+<h4 id="docforge.renderers.MCPRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MCPRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Renderer that emits MCP-native JSON resources from docforge models.</p>
+      <p>Renderer that generates MCP-compatible documentation resources.</p>
+<p>This renderer converts doc-forge project models into structured JSON
+resources suitable for consumption by systems implementing the Model
+Context Protocol (MCP).</p>
 
 
 
@@ -1396,22 +1179,24 @@ engines.</p>
 
 
 
-
+<h5 id="docforge.renderers.MCPRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.renderers.MCPRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.renderers.MCPRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate MCP-compatible JSON resources and navigation for the project.</p>
+      <p>Generate MCP documentation resources for a project.</p>
+<p>The renderer serializes each module into a JSON resource and produces
+supporting metadata files such as <code>nav.json</code> and <code>index.json</code>.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1432,7 +1217,7 @@ engines.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project model to render.</p>
+                <p>Documentation project model to render.</p>
               </div>
             </td>
             <td>
@@ -1446,7 +1231,7 @@ engines.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for the generated JSON files.</p>
+                <p>Directory where MCP resources will be written.</p>
               </div>
             </td>
             <td>
@@ -1472,18 +1257,19 @@ engines.</p>
 
 
 
-<h3 id="docforge.renderers.MkDocsRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MkDocsRenderer</span>
+<h4 id="docforge.renderers.MkDocsRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MkDocsRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Renderer that generates Markdown source files formatted for the MkDocs
-'mkdocstrings' plugin.</p>
+      <p>Renderer that produces Markdown documentation for MkDocs.</p>
+<p>Generated pages use mkdocstrings directives to reference Python modules,
+allowing MkDocs to render API documentation dynamically.</p>
 
 
 
@@ -1496,23 +1282,28 @@ engines.</p>
 
 
 
-
+<h5 id="docforge.renderers.MkDocsRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.renderers.MkDocsRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.renderers.MkDocsRenderer.generate_readme" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_readme</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_readme</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Produce a set of Markdown files in the output directory based on the
-provided Project models.</p>
+      <p>Generate a <code>README.md</code> file from the root module docstring.</p>
+<p>Behavior:</p>
+<ul>
+<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the
+  project root directory.</li>
+<li>If False, README generation is currently not implemented.</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1533,7 +1324,7 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project models to render.</p>
+                <p>Project model containing documentation metadata.</p>
               </div>
             </td>
             <td>
@@ -1541,13 +1332,13 @@ provided Project models.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>out_dir</code></td>
+            <td><code>docs_dir</code></td>
             <td>
                   <code><span title="pathlib.Path">Path</span></code>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for documentation files.</p>
+                <p>Directory containing generated documentation sources.</p>
               </div>
             </td>
             <td>
@@ -1561,7 +1352,88 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module is the source folder and to be treated as the root folder.</p>
+                <p>Whether the module is treated as the project
+source root.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h6 id="docforge.renderers.MkDocsRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+
+
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
+
+    <div class="doc doc-contents ">
+
+      <p>Generate Markdown documentation files for a project.</p>
+<p>This method renders a documentation structure from the provided
+project model and writes the resulting Markdown files to the
+specified output directory.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>project</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="docforge.models.Project" href="../models/#docforge.models.Project">Project</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Project model containing modules to document.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>out_dir</code></td>
+            <td>
+                  <code><span title="pathlib.Path">Path</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Directory where generated Markdown files will be written.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>module_is_source</code></td>
+            <td>
+                  <code>bool | None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If True, treat the specified module as the
+documentation root rather than nesting it inside a folder.</p>
               </div>
             </td>
             <td>
@@ -1608,6 +1480,8 @@ provided Project models.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1645,7 +1519,7 @@ provided Project models.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/renderers/mcp_renderer/index.html b/libs/doc-forge/site/renderers/mcp_renderer/index.html
index 0fe22e1..dd2ad5f 100644
--- a/libs/doc-forge/site/renderers/mcp_renderer/index.html
+++ b/libs/doc-forge/site/renderers/mcp_renderer/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -752,6 +625,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -759,7 +644,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -769,8 +653,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -779,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5">
@@ -790,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -925,6 +795,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.mcp_renderer-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.mcp_renderer.MCPRenderer" class="md-nav__link">
     <span class="md-ellipsis">
       MCPRenderer
@@ -935,6 +815,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.mcp_renderer.MCPRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.mcp_renderer.MCPRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -951,6 +841,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -977,13 +877,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -992,8 +908,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1002,8 +919,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1013,27 +936,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1171,6 +1073,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.mcp_renderer-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.mcp_renderer.MCPRenderer" class="md-nav__link">
     <span class="md-ellipsis">
       MCPRenderer
@@ -1181,6 +1093,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.mcp_renderer.MCPRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.mcp_renderer.MCPRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
       generate_sources
@@ -1197,6 +1119,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1223,7 +1155,7 @@
 
 
 <h2 id="docforge.renderers.mcp_renderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.renderers.mcp_renderer</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.renderers.mcp_renderer</span>
 
 
 </h2>
@@ -1239,23 +1171,26 @@
 
 
 
-
+<h3 id="docforge.renderers.mcp_renderer-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.renderers.mcp_renderer.MCPRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MCPRenderer</span>
+<h4 id="docforge.renderers.mcp_renderer.MCPRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MCPRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Renderer that emits MCP-native JSON resources from docforge models.</p>
+      <p>Renderer that generates MCP-compatible documentation resources.</p>
+<p>This renderer converts doc-forge project models into structured JSON
+resources suitable for consumption by systems implementing the Model
+Context Protocol (MCP).</p>
 
 
 
@@ -1268,22 +1203,24 @@
 
 
 
-
+<h5 id="docforge.renderers.mcp_renderer.MCPRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.renderers.mcp_renderer.MCPRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.renderers.mcp_renderer.MCPRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Generate MCP-compatible JSON resources and navigation for the project.</p>
+      <p>Generate MCP documentation resources for a project.</p>
+<p>The renderer serializes each module into a JSON resource and produces
+supporting metadata files such as <code>nav.json</code> and <code>index.json</code>.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1304,7 +1241,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project model to render.</p>
+                <p>Documentation project model to render.</p>
               </div>
             </td>
             <td>
@@ -1318,7 +1255,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for the generated JSON files.</p>
+                <p>Directory where MCP resources will be written.</p>
               </div>
             </td>
             <td>
@@ -1365,6 +1302,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1402,7 +1341,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/renderers/mkdocs_renderer/index.html b/libs/doc-forge/site/renderers/mkdocs_renderer/index.html
index 0170bb1..dd3dfe5 100644
--- a/libs/doc-forge/site/renderers/mkdocs_renderer/index.html
+++ b/libs/doc-forge/site/renderers/mkdocs_renderer/index.html
@@ -86,7 +86,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -151,12 +153,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -182,136 +191,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-    
-  
-  
-    
-    
-      <li class="md-tabs__item md-tabs__item--active">
-        <a href="../" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -325,10 +204,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -371,13 +248,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -386,8 +273,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -396,8 +284,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -407,27 +301,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -467,13 +340,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -482,8 +369,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -492,8 +380,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -503,27 +397,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -609,13 +482,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -624,8 +511,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -634,8 +522,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -645,27 +539,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -752,6 +625,18 @@
   
   
     
+    
+      
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
     
     
     
@@ -759,7 +644,6 @@
         
         
       
-      
     
     
     <li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">
@@ -769,8 +653,9 @@
         <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -779,8 +664,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">
           <label class="md-nav__title" for="__nav_5">
@@ -790,27 +681,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -902,6 +772,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.mkdocs_renderer-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer" class="md-nav__link">
     <span class="md-ellipsis">
       MkDocsRenderer
@@ -911,6 +791,25 @@
     <nav class="md-nav" aria-label="MkDocsRenderer">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      generate_readme
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
@@ -928,6 +827,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -977,13 +886,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -992,8 +917,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -1002,8 +928,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -1013,27 +945,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1171,6 +1082,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.renderers.mkdocs_renderer-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer" class="md-nav__link">
     <span class="md-ellipsis">
       MkDocsRenderer
@@ -1180,6 +1101,25 @@
     <nav class="md-nav" aria-label="MkDocsRenderer">
       <ul class="md-nav__list">
         
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
+  <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme" class="md-nav__link">
+    <span class="md-ellipsis">
+      generate_readme
+    </span>
+  </a>
+  
+</li>
+        
           <li class="md-nav__item">
   <a href="#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources" class="md-nav__link">
     <span class="md-ellipsis">
@@ -1197,6 +1137,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1223,20 +1173,23 @@
 
 
 <h2 id="docforge.renderers.mkdocs_renderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.renderers.mkdocs_renderer</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.renderers.mkdocs_renderer</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
-      <p>MkDocsRenderer</p>
-<p>Generates Markdown source files compatible with MkDocs Material
-and mkdocstrings, ensuring:</p>
+      <p>MkDocs renderer implementation.</p>
+<p>This module defines the <code>MkDocsRenderer</code> class, which generates Markdown
+documentation sources compatible with MkDocs Material and the mkdocstrings
+plugin.</p>
+<p>The renderer ensures a consistent documentation structure by:</p>
 <ul>
-<li>Root index.md always exists</li>
-<li>Parent package indexes are created automatically</li>
-<li>Child modules are linked in parent index files</li>
+<li>Creating a root <code>index.md</code> if one does not exist</li>
+<li>Generating package index pages automatically</li>
+<li>Linking child modules within parent package pages</li>
+<li>Optionally generating <code>README.md</code> from the root package docstring</li>
 </ul>
 
 
@@ -1248,24 +1201,25 @@ and mkdocstrings, ensuring:</p>
 
 
 
-
+<h3 id="docforge.renderers.mkdocs_renderer-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.renderers.mkdocs_renderer.MkDocsRenderer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MkDocsRenderer</span>
+<h4 id="docforge.renderers.mkdocs_renderer.MkDocsRenderer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MkDocsRenderer</span>
 
 
-</h3>
+</h4>
 
 
     <div class="doc doc-contents ">
 
 
-      <p>Renderer that generates Markdown source files formatted for the MkDocs
-'mkdocstrings' plugin.</p>
+      <p>Renderer that produces Markdown documentation for MkDocs.</p>
+<p>Generated pages use mkdocstrings directives to reference Python modules,
+allowing MkDocs to render API documentation dynamically.</p>
 
 
 
@@ -1278,23 +1232,28 @@ and mkdocstrings, ensuring:</p>
 
 
 
-
+<h5 id="docforge.renderers.mkdocs_renderer.MkDocsRenderer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+<h6 id="docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_readme</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_readme</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">docs_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
-      <p>Produce a set of Markdown files in the output directory based on the
-provided Project models.</p>
+      <p>Generate a <code>README.md</code> file from the root module docstring.</p>
+<p>Behavior:</p>
+<ul>
+<li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the
+  project root directory.</li>
+<li>If False, README generation is currently not implemented.</li>
+</ul>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1315,7 +1274,7 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>The project models to render.</p>
+                <p>Project model containing documentation metadata.</p>
               </div>
             </td>
             <td>
@@ -1323,13 +1282,13 @@ provided Project models.</p>
             </td>
           </tr>
           <tr class="doc-section-item">
-            <td><code>out_dir</code></td>
+            <td><code>docs_dir</code></td>
             <td>
                   <code><span title="pathlib.Path">Path</span></code>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Target directory for documentation files.</p>
+                <p>Directory containing generated documentation sources.</p>
               </div>
             </td>
             <td>
@@ -1343,7 +1302,88 @@ provided Project models.</p>
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Module is the source folder and to be treated as the root folder.</p>
+                <p>Whether the module is treated as the project
+source root.</p>
+              </div>
+            </td>
+            <td>
+                  <code>None</code>
+            </td>
+          </tr>
+      </tbody>
+    </table>
+
+    </div>
+
+</div>
+
+<div class="doc doc-object doc-function">
+
+
+<h6 id="docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">generate_sources</span>
+
+
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">generate_sources</span><span class="p">(</span><span class="n">project</span><span class="p">:</span> <span class="n">Project</span><span class="p">,</span> <span class="n">out_dir</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">module_is_source</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
+
+    <div class="doc doc-contents ">
+
+      <p>Generate Markdown documentation files for a project.</p>
+<p>This method renders a documentation structure from the provided
+project model and writes the resulting Markdown files to the
+specified output directory.</p>
+
+
+<p><span class="doc-section-title">Parameters:</span></p>
+    <table>
+      <thead>
+        <tr>
+          <th>Name</th>
+          <th>Type</th>
+          <th>Description</th>
+          <th>Default</th>
+        </tr>
+      </thead>
+      <tbody>
+          <tr class="doc-section-item">
+            <td><code>project</code></td>
+            <td>
+                  <code><a class="autorefs autorefs-internal" title="docforge.models.Project" href="../../models/#docforge.models.Project">Project</a></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Project model containing modules to document.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>out_dir</code></td>
+            <td>
+                  <code><span title="pathlib.Path">Path</span></code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>Directory where generated Markdown files will be written.</p>
+              </div>
+            </td>
+            <td>
+                <em>required</em>
+            </td>
+          </tr>
+          <tr class="doc-section-item">
+            <td><code>module_is_source</code></td>
+            <td>
+                  <code>bool | None</code>
+            </td>
+            <td>
+              <div class="doc-md-description">
+                <p>If True, treat the specified module as the
+documentation root rather than nesting it inside a folder.</p>
               </div>
             </td>
             <td>
@@ -1390,6 +1430,8 @@ provided Project models.</p>
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1427,7 +1469,7 @@ provided Project models.</p>
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/search/search_index.json b/libs/doc-forge/site/search/search_index.json
index 547001c..d53ff9a 100644
--- a/libs/doc-forge/site/search/search_index.json
+++ b/libs/doc-forge/site/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"docforge","text":""},{"location":"#docforge","title":"docforge","text":""},{"location":"#docforge--doc-forge","title":"doc-forge","text":"<p><code>doc-forge</code> is a renderer-agnostic Python documentation compiler designed for speed, flexibility, and beautiful output. It decouples the introspection of your code from the rendering process, allowing you to generate documentation for various platforms (starting with MkDocs) from a single internal models.</p>"},{"location":"#docforge--core-philosophy","title":"Core Philosophy","text":"<p><code>doc-forge</code> operates on two fundamental principles:</p> <ol> <li>The Atomic Unit is a Python Import Path: Documentation is organized around the semantic structure of your code (e.g., <code>mypackage.utils</code>), not the filesystem.</li> <li>The Documentation Compiler Paradigm: We separate documentation into three distinct phases:<ul> <li>Front-end (Introspection): Static analysis of source code and docstrings.</li> <li>Middle-end (Semantic Model): A renderer-neutral internal representation.</li> <li>Back-end (Renderers): Generation of human-facing (MkDocs) or machine-facing (MCP) outputs.</li> </ul> </li> </ol>"},{"location":"#docforge--documentation-design","title":"Documentation Design","text":"<p><code>doc-forge</code> is an \"AI-Native\" documentation compiler. To get the most out of it, design your docstrings with both humans and LLMs in mind:</p>"},{"location":"#docforge--for-humans-readability-structure","title":"For Humans (Readability &amp; Structure)","text":"<ul> <li><code>__init__.py</code> as Landing Pages: Use the docstring of your package's <code>__init__.py</code> as the home page. Include overviews, installation instructions, and high-level examples here.</li> <li>Single Source of Truth: Keep all technical details in docstrings. This ensures your MkDocs/Sphinx sites stay in sync with the code.</li> <li>Semantic Hierarchy: Use standard Markdown headers to structure complex module documentation.</li> </ul>"},{"location":"#docforge--for-llms-ai-native-knowledge","title":"For LLMs (AI-Native Knowledge)","text":"<ul> <li>Model Context Protocol (MCP): <code>doc-forge</code> exports your docs as structured JSON. This allows AI agents to \"understand\" your API surface area without layout noise.</li> <li>Canonical Paths: Use dotted import paths as primary identifiers. AI tools use these to link code usage to documentation.</li> <li>Type Annotations: While not in docstrings, <code>doc-forge</code> (via Griffe) extracts signatures. Clean type hints dramatically improve an LLM's ability to generate correct code using your library.</li> </ul>"},{"location":"#docforge--available-commands","title":"Available Commands","text":"<ul> <li>build: Build documentation (MkDocs site or MCP resources).</li> <li>serve: Serve documentation (MkDocs or MCP).</li> <li>tree: Visualize the introspected project structure.</li> </ul>"},{"location":"#docforge--installation","title":"Installation","text":"<p>Install using <code>pip</code> with the optional <code>mkdocs</code> dependencies for a complete setup:</p> <pre><code>pip install doc-forge\n</code></pre>"},{"location":"#docforge--quick-start","title":"Quick Start","text":"<ol> <li> <p>Build Documentation:     Introspect your package and generate documentation in one step:     ```bash     # Build MkDocs site     doc-forge build --mkdocs --module my_package --site-name \"My Docs\"</p> </li> <li> <p>Define Navigation:     Create a <code>docforge.nav.yml</code> to organize your documentation:     <code>yaml     home: my_package/index.md     groups:       Core API:         - my_package/core/*.md       Utilities:         - my_package/utils.md</code></p> </li> <li> <p>Preview:     ```bash     # Serve MkDocs site     doc-forge serve --mkdocs</p> </li> </ol>"},{"location":"#docforge--build-mcp-resources","title":"Build MCP resources","text":"<p>doc-forge build --mcp --module my_package ```</p>"},{"location":"#docforge--serve-mcp-documentation","title":"Serve MCP documentation","text":"<p>doc-forge serve --mcp ```</p>"},{"location":"#docforge--project-structure","title":"Project Structure","text":"<ul> <li><code>docforge.loaders</code>: Introspects source code using static analysis (<code>griffe</code>).</li> <li><code>docforge.models</code>: The internal representation of your project, modules, and objects.</li> <li><code>docforge.renderers</code>: Converters that turn the models into physical files.</li> <li><code>docforge.nav</code>: Managers for logical-to-physical path mapping and navigation.</li> </ul>"},{"location":"#docforge.GriffeLoader","title":"GriffeLoader","text":"<pre><code>GriffeLoader()\n</code></pre> <p>Loads Python modules and extracts documentation using the Griffe introspection engine.</p> <p>Initialize the GriffeLoader.</p>"},{"location":"#docforge.GriffeLoader.load_module","title":"load_module","text":"<pre><code>load_module(path: str) -&gt; Module\n</code></pre> <p>Load a single module and convert its introspection data into the docforge models.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module to load.</p> required <p>Returns:</p> Type Description <code>Module</code> <p>A Module instance.</p>"},{"location":"#docforge.GriffeLoader.load_project","title":"load_project","text":"<pre><code>load_project(module_paths: List[str], project_name: Optional[str] = None, skip_import_errors: bool = None) -&gt; Project\n</code></pre> <p>Load multiple modules and combine them into a single Project models.</p> <p>Parameters:</p> Name Type Description Default <code>module_paths</code> <code>List[str]</code> <p>A list of dotted paths to the modules to load.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional name for the project. Defaults to the first module name.</p> <code>None</code> <code>skip_import_errors</code> <code>bool</code> <p>If True, modules that fail to import will be skipped.</p> <code>None</code> <p>Returns:</p> Type Description <code>Project</code> <p>A Project instance containing the loaded modules.</p>"},{"location":"#docforge.MCPRenderer","title":"MCPRenderer","text":"<p>Renderer that emits MCP-native JSON resources from docforge models.</p>"},{"location":"#docforge.MCPRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP-compatible JSON resources and navigation for the project.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project model to render.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for the generated JSON files.</p> required"},{"location":"#docforge.MkDocsRenderer","title":"MkDocsRenderer","text":"<p>Renderer that generates Markdown source files formatted for the MkDocs 'mkdocstrings' plugin.</p>"},{"location":"#docforge.MkDocsRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Produce a set of Markdown files in the output directory based on the provided Project models.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project models to render.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for documentation files.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Module is the source folder and to be treated as the root folder.</p> <code>None</code>"},{"location":"#docforge.discover_module_paths","title":"discover_module_paths","text":"<pre><code>discover_module_paths(module_name: str, project_root: Path | None = None) -&gt; List[str]\n</code></pre> <p>Discover all Python modules under a package via filesystem traversal.</p> <p>Rules: - Directory with init.py is treated as a package. - Any .py file is treated as a module. - All paths are converted to dotted module paths.</p> <p>Parameters:</p> Name Type Description Default <code>module_name</code> <code>str</code> <p>The name of the package to discover.</p> required <code>project_root</code> <code>Path | None</code> <p>The root directory of the project. Defaults to current working directory.</p> <code>None</code> <p>Returns:</p> Type Description <code>List[str]</code> <p>A sorted list of dotted module paths.</p>"},{"location":"cli/","title":"Cli","text":""},{"location":"cli/#docforge.cli","title":"docforge.cli","text":""},{"location":"cli/#docforge.cli--cli-layer","title":"CLI Layer","text":"<p>The <code>docforge.cli</code> package provides the command-line interface for interacting with doc-forge.</p>"},{"location":"cli/#docforge.cli--available-commands","title":"Available Commands","text":"<ul> <li>build: Build documentation (MkDocs site or MCP resources).</li> <li>serve: Serve documentation (MkDocs or MCP).</li> <li>tree: Visualize the introspected project structure.</li> </ul>"},{"location":"cli/commands/","title":"Commands","text":""},{"location":"cli/commands/#docforge.cli.commands","title":"docforge.cli.commands","text":""},{"location":"cli/commands/#docforge.cli.commands.build","title":"build","text":"<pre><code>build(mcp: bool, mkdocs: bool, module_is_source: bool, module: Optional[str], project_name: Optional[str], site_name: Optional[str], docs_dir: Path, nav_file: Path, template: Optional[Path], mkdocs_yml: Path, out_dir: Path) -&gt; None\n</code></pre> <p>Build documentation (MkDocs site or MCP resources).</p> <p>This command orchestrates the full build process: 1. Introspects the code (Griffe) 2. Renders sources (MkDocs Markdown or MCP JSON) 3. (MkDocs only) Generates config and runs the final site build.</p> <p>Parameters:</p> Name Type Description Default <code>mcp</code> <code>bool</code> <p>Use the MCP documentation builder.</p> required <code>mkdocs</code> <code>bool</code> <p>Use the MkDocs documentation builder.</p> required <code>module_is_source</code> <code>bool</code> <p>Module is the source folder and to be treated as the root folder.</p> required <code>module</code> <code>Optional[str]</code> <p>The dotted path of the module to the document.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional override for the project name.</p> required <code>site_name</code> <code>Optional[str]</code> <p>(MkDocs) The site display name. Defaults to module name.</p> required <code>docs_dir</code> <code>Path</code> <p>(MkDocs) Target directory for Markdown sources.</p> required <code>nav_file</code> <code>Path</code> <p>(MkDocs) Path to the docforge.nav.yml specification.</p> required <code>template</code> <code>Optional[Path]</code> <p>(MkDocs) Optional custom mkdocs.yml template.</p> required <code>mkdocs_yml</code> <code>Path</code> <p>(MkDocs) Target path for the generated mkdocs.yml.</p> required <code>out_dir</code> <code>Path</code> <p>(MCP) Target directory for MCP JSON resources.</p> required"},{"location":"cli/commands/#docforge.cli.commands.serve","title":"serve","text":"<pre><code>serve(mcp: bool, mkdocs: bool, module: Optional[str], mkdocs_yml: Path, out_dir: Path) -&gt; None\n</code></pre> <p>Serve documentation (MkDocs or MCP).</p> <p>Parameters:</p> Name Type Description Default <code>mcp</code> <code>bool</code> <p>Serve MCP resources via an MCP server.</p> required <code>mkdocs</code> <code>bool</code> <p>Serve the MkDocs site using the built-in development server.</p> required <code>module</code> <code>Optional[str]</code> <p>The dotted path of the module to serve.</p> required <code>mkdocs_yml</code> <code>Path</code> <p>(MkDocs) Path to the mkdocs.yml configuration.</p> required <code>out_dir</code> <code>Path</code> <p>(MCP) Path to the mcp_docs/ directory.</p> required"},{"location":"cli/commands/#docforge.cli.commands.tree","title":"tree","text":"<pre><code>tree(module: str, project_name: Optional[str]) -&gt; None\n</code></pre> <p>Visualize the project structure in the terminal.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>The module import path to recursively introspect.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional override for the project name shown at the root.</p> required"},{"location":"cli/main/","title":"Main","text":""},{"location":"cli/main/#docforge.cli.main","title":"docforge.cli.main","text":"<p>Main entry point for the doc-forge CLI. This module delegates all command execution to docforge.cli.commands.</p>"},{"location":"cli/main/#docforge.cli.main.main","title":"main","text":"<pre><code>main() -&gt; None\n</code></pre> <p>CLI Entry point. Boots the click application.</p>"},{"location":"cli/mcp_utils/","title":"Mcp Utils","text":""},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils","title":"docforge.cli.mcp_utils","text":""},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils.generate_resources","title":"generate_resources","text":"<pre><code>generate_resources(module: str, project_name: str | None, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP-compatible documentation resources.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>The dotted path of the primary module to document.</p> required <code>project_name</code> <code>str | None</code> <p>Optional override for the project name.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where the MCP JSON resources and nav will be written.</p> required"},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils.serve","title":"serve","text":"<pre><code>serve(module: str, mcp_root: Path) -&gt; None\n</code></pre> <p>Serve MCP documentation from a pre-built bundle.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>The dotted path of the primary module to serve.</p> required <code>mcp_root</code> <code>Path</code> <p>Path to the directory containing index.json, nav.json, and modules/.</p> required"},{"location":"cli/mkdocs_utils/","title":"Mkdocs Utils","text":""},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils","title":"docforge.cli.mkdocs_utils","text":""},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.build","title":"build","text":"<pre><code>build(mkdocs_yml: Path) -&gt; None\n</code></pre> <p>Build the documentation site using MkDocs.</p> <p>Parameters:</p> Name Type Description Default <code>mkdocs_yml</code> <code>Path</code> <p>Path to the mkdocs.yml configuration file.</p> required"},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.generate_config","title":"generate_config","text":"<pre><code>generate_config(docs_dir: Path, nav_file: Path, template: Path | None, out: Path, site_name: str) -&gt; None\n</code></pre> <p>Generate an mkdocs.yml configuration file.</p> <p>Parameters:</p> Name Type Description Default <code>docs_dir</code> <code>Path</code> <p>Path to the directory containing documentation Markdown files.</p> required <code>nav_file</code> <code>Path</code> <p>Path to the docforge.nav.yml specification.</p> required <code>template</code> <code>Path | None</code> <p>Optional path to an mkdocs.yml template (overrides built-in).</p> required <code>out</code> <code>Path</code> <p>Path where the final mkdocs.yml will be written.</p> required <code>site_name</code> <code>str</code> <p>The display name for the documentation site.</p> required"},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(module: str, docs_dir: Path, project_name: str | None = None, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate Markdown source files for the specified module.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>The dotted path of the primary module to document.</p> required <code>project_name</code> <code>str | None</code> <p>Optional override for the project name.</p> <code>None</code> <code>docs_dir</code> <code>Path</code> <p>Directory where the generated Markdown files will be written.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Module is the source folder and to be treated as the root folder.</p> <code>None</code>"},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.serve","title":"serve","text":"<pre><code>serve(mkdocs_yml: Path) -&gt; None\n</code></pre> <p>Serve the documentation site with live-reload using MkDocs.</p> <p>Parameters:</p> Name Type Description Default <code>mkdocs_yml</code> <code>Path</code> <p>Path to the mkdocs.yml configuration file.</p> required"},{"location":"loaders/","title":"Loaders","text":""},{"location":"loaders/#docforge.loaders","title":"docforge.loaders","text":""},{"location":"loaders/#docforge.loaders--loader-layer","title":"Loader Layer","text":"<p>The <code>docforge.loaders</code> package is responsible for discovering Python source files and extracting their documentation using static analysis.</p>"},{"location":"loaders/#docforge.loaders--core-features","title":"Core Features","text":"<ul> <li>Discovery: Automatically find all modules and packages in a project   directory.</li> <li>Introspection: Uses <code>griffe</code> to parse docstrings, signatures, and   hierarchical relationships without executing the code.</li> <li>Filtering: Automatically excludes private members (prefixed with <code>_</code>) to   ensure clean public documentation.</li> </ul>"},{"location":"loaders/#docforge.loaders.GriffeLoader","title":"GriffeLoader","text":"<pre><code>GriffeLoader()\n</code></pre> <p>Loads Python modules and extracts documentation using the Griffe introspection engine.</p> <p>Initialize the GriffeLoader.</p>"},{"location":"loaders/#docforge.loaders.GriffeLoader.load_module","title":"load_module","text":"<pre><code>load_module(path: str) -&gt; Module\n</code></pre> <p>Load a single module and convert its introspection data into the docforge models.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module to load.</p> required <p>Returns:</p> Type Description <code>Module</code> <p>A Module instance.</p>"},{"location":"loaders/#docforge.loaders.GriffeLoader.load_project","title":"load_project","text":"<pre><code>load_project(module_paths: List[str], project_name: Optional[str] = None, skip_import_errors: bool = None) -&gt; Project\n</code></pre> <p>Load multiple modules and combine them into a single Project models.</p> <p>Parameters:</p> Name Type Description Default <code>module_paths</code> <code>List[str]</code> <p>A list of dotted paths to the modules to load.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional name for the project. Defaults to the first module name.</p> <code>None</code> <code>skip_import_errors</code> <code>bool</code> <p>If True, modules that fail to import will be skipped.</p> <code>None</code> <p>Returns:</p> Type Description <code>Project</code> <p>A Project instance containing the loaded modules.</p>"},{"location":"loaders/#docforge.loaders.discover_module_paths","title":"discover_module_paths","text":"<pre><code>discover_module_paths(module_name: str, project_root: Path | None = None) -&gt; List[str]\n</code></pre> <p>Discover all Python modules under a package via filesystem traversal.</p> <p>Rules: - Directory with init.py is treated as a package. - Any .py file is treated as a module. - All paths are converted to dotted module paths.</p> <p>Parameters:</p> Name Type Description Default <code>module_name</code> <code>str</code> <p>The name of the package to discover.</p> required <code>project_root</code> <code>Path | None</code> <p>The root directory of the project. Defaults to current working directory.</p> <code>None</code> <p>Returns:</p> Type Description <code>List[str]</code> <p>A sorted list of dotted module paths.</p>"},{"location":"loaders/griffe_loader/","title":"Griffe Loader","text":""},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader","title":"docforge.loaders.griffe_loader","text":"<p>This module provides the GriffeLoader, which uses the 'griffe' library to introspect Python source code and populate the doc-forge Project models.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader","title":"GriffeLoader","text":"<pre><code>GriffeLoader()\n</code></pre> <p>Loads Python modules and extracts documentation using the Griffe introspection engine.</p> <p>Initialize the GriffeLoader.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader.load_module","title":"load_module","text":"<pre><code>load_module(path: str) -&gt; Module\n</code></pre> <p>Load a single module and convert its introspection data into the docforge models.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module to load.</p> required <p>Returns:</p> Type Description <code>Module</code> <p>A Module instance.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader.load_project","title":"load_project","text":"<pre><code>load_project(module_paths: List[str], project_name: Optional[str] = None, skip_import_errors: bool = None) -&gt; Project\n</code></pre> <p>Load multiple modules and combine them into a single Project models.</p> <p>Parameters:</p> Name Type Description Default <code>module_paths</code> <code>List[str]</code> <p>A list of dotted paths to the modules to load.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional name for the project. Defaults to the first module name.</p> <code>None</code> <code>skip_import_errors</code> <code>bool</code> <p>If True, modules that fail to import will be skipped.</p> <code>None</code> <p>Returns:</p> Type Description <code>Project</code> <p>A Project instance containing the loaded modules.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.discover_module_paths","title":"discover_module_paths","text":"<pre><code>discover_module_paths(module_name: str, project_root: Path | None = None) -&gt; List[str]\n</code></pre> <p>Discover all Python modules under a package via filesystem traversal.</p> <p>Rules: - Directory with init.py is treated as a package. - Any .py file is treated as a module. - All paths are converted to dotted module paths.</p> <p>Parameters:</p> Name Type Description Default <code>module_name</code> <code>str</code> <p>The name of the package to discover.</p> required <code>project_root</code> <code>Path | None</code> <p>The root directory of the project. Defaults to current working directory.</p> <code>None</code> <p>Returns:</p> Type Description <code>List[str]</code> <p>A sorted list of dotted module paths.</p>"},{"location":"models/","title":"Models","text":""},{"location":"models/#docforge.models","title":"docforge.models","text":""},{"location":"models/#docforge.models--model-layer","title":"Model Layer","text":"<p>The <code>docforge.models</code> package provides the core data structures used to represent Python source code in a documentation-focused hierarchy.</p>"},{"location":"models/#docforge.models--key-components","title":"Key Components","text":"<ul> <li>Project: The root container for all documented modules.</li> <li>Module: Represents a Python module or package, containing members.</li> <li>DocObject: A recursive structure for classes, functions, and attributes.</li> </ul> <p>These classes are designed to be renderer-agnostic, allowing the same internal representation to be transformed into various output formats (currently MkDocs).</p>"},{"location":"models/#docforge.models.DocObject","title":"DocObject","text":"<pre><code>DocObject(name: str, kind: str, path: str, signature: Optional[str] = None, docstring: Optional[str] = None)\n</code></pre> <p>Represents a documented Python object (class, function, method, etc.).</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Local name of the object.</p> <code>kind</code> <code>str</code> <p>Type of object (e.g., 'class', 'function', 'attribute').</p> <code>path</code> <code>str</code> <p>Full dotted import path to the object.</p> <code>signature</code> <code>Optional[str]</code> <p>Callable signature, if applicable.</p> <code>docstring</code> <code>Optional[str]</code> <p>Raw docstring content extracted from the source.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Dictionary mapping member names to their DocObject representations.</p> <p>Initialize a new DocObject.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The local name of the object.</p> required <code>kind</code> <code>str</code> <p>The kind of object (e.g., 'class', 'function').</p> required <code>path</code> <code>str</code> <p>The full dotted path to the object.</p> required <code>signature</code> <code>Optional[str]</code> <p>The object's signature (for callable objects).</p> <code>None</code> <code>docstring</code> <code>Optional[str]</code> <p>The object's docstring, if any.</p> <code>None</code>"},{"location":"models/#docforge.models.DocObject.add_member","title":"add_member","text":"<pre><code>add_member(obj: DocObject) -&gt; None\n</code></pre> <p>Add a child member to this object (e.g., a method to a class).</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>The child DocObject to add.</p> required"},{"location":"models/#docforge.models.DocObject.get_all_members","title":"get_all_members","text":"<pre><code>get_all_members() -&gt; Iterable[DocObject]\n</code></pre> <p>Get all members of this object.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of child DocObject instances.</p>"},{"location":"models/#docforge.models.DocObject.get_member","title":"get_member","text":"<pre><code>get_member(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a child member by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the member.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The requested DocObject.</p>"},{"location":"models/#docforge.models.Module","title":"Module","text":"<pre><code>Module(path: str, docstring: Optional[str] = None)\n</code></pre> <p>Represents a documented Python module or package.</p> <p>Attributes:</p> Name Type Description <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> <code>docstring</code> <code>Optional[str]</code> <p>Module-level docstring content.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Dictionary mapping object names to their DocObject representations.</p> <p>Initialize a new Module.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module.</p> required <code>docstring</code> <code>Optional[str]</code> <p>The module's docstring, if any.</p> <code>None</code>"},{"location":"models/#docforge.models.Module.add_object","title":"add_object","text":"<pre><code>add_object(obj: DocObject) -&gt; None\n</code></pre> <p>Add a documented object to the module.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>The object to add.</p> required"},{"location":"models/#docforge.models.Module.get_all_objects","title":"get_all_objects","text":"<pre><code>get_all_objects() -&gt; Iterable[DocObject]\n</code></pre> <p>Get all top-level objects in the module.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of DocObject instances.</p>"},{"location":"models/#docforge.models.Module.get_object","title":"get_object","text":"<pre><code>get_object(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a member object by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the object.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The requested DocObject.</p>"},{"location":"models/#docforge.models.Project","title":"Project","text":"<pre><code>Project(name: str)\n</code></pre> <p>Represents a documentation project, serving as a container for modules.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Name of the project.</p> <code>modules</code> <code>Dict[str, Module]</code> <p>Dictionary mapping module paths to Module instances.</p> <p>Initialize a new Project.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the project.</p> required"},{"location":"models/#docforge.models.Project.add_module","title":"add_module","text":"<pre><code>add_module(module: Module) -&gt; None\n</code></pre> <p>Add a module to the project.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>Module</code> <p>The module to add.</p> required"},{"location":"models/#docforge.models.Project.get_all_modules","title":"get_all_modules","text":"<pre><code>get_all_modules() -&gt; Iterable[Module]\n</code></pre> <p>Get all modules in the project.</p> <p>Returns:</p> Type Description <code>Iterable[Module]</code> <p>An iterable of Module objects.</p>"},{"location":"models/#docforge.models.Project.get_module","title":"get_module","text":"<pre><code>get_module(path: str) -&gt; Module\n</code></pre> <p>Retrieve a module by its dotted path.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module (e.g., 'pkg.mod').</p> required <p>Returns:</p> Type Description <code>Module</code> <p>The requested Module.</p>"},{"location":"models/#docforge.models.Project.get_module_list","title":"get_module_list","text":"<pre><code>get_module_list() -&gt; list[str]\n</code></pre> <p>Get the list of all module dotted paths.</p> <p>Returns:</p> Type Description <code>list[str]</code> <p>A list of module paths.</p>"},{"location":"models/module/","title":"Module","text":""},{"location":"models/module/#docforge.models.module","title":"docforge.models.module","text":"<p>This module defines the Module class, which represents a Python module or package in the doc-forge documentation models. It acts as a container for top-level documented objects.</p>"},{"location":"models/module/#docforge.models.module.Module","title":"Module","text":"<pre><code>Module(path: str, docstring: Optional[str] = None)\n</code></pre> <p>Represents a documented Python module or package.</p> <p>Attributes:</p> Name Type Description <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> <code>docstring</code> <code>Optional[str]</code> <p>Module-level docstring content.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Dictionary mapping object names to their DocObject representations.</p> <p>Initialize a new Module.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module.</p> required <code>docstring</code> <code>Optional[str]</code> <p>The module's docstring, if any.</p> <code>None</code>"},{"location":"models/module/#docforge.models.module.Module.add_object","title":"add_object","text":"<pre><code>add_object(obj: DocObject) -&gt; None\n</code></pre> <p>Add a documented object to the module.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>The object to add.</p> required"},{"location":"models/module/#docforge.models.module.Module.get_all_objects","title":"get_all_objects","text":"<pre><code>get_all_objects() -&gt; Iterable[DocObject]\n</code></pre> <p>Get all top-level objects in the module.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of DocObject instances.</p>"},{"location":"models/module/#docforge.models.module.Module.get_object","title":"get_object","text":"<pre><code>get_object(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a member object by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the object.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The requested DocObject.</p>"},{"location":"models/object/","title":"Object","text":""},{"location":"models/object/#docforge.models.object","title":"docforge.models.object","text":"<p>This module defines the DocObject class, the fundamental recursive unit of the doc-forge documentation models. A DocObject represents a single Python entity (class, function, method, or attribute) and its nested members.</p>"},{"location":"models/object/#docforge.models.object.DocObject","title":"DocObject","text":"<pre><code>DocObject(name: str, kind: str, path: str, signature: Optional[str] = None, docstring: Optional[str] = None)\n</code></pre> <p>Represents a documented Python object (class, function, method, etc.).</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Local name of the object.</p> <code>kind</code> <code>str</code> <p>Type of object (e.g., 'class', 'function', 'attribute').</p> <code>path</code> <code>str</code> <p>Full dotted import path to the object.</p> <code>signature</code> <code>Optional[str]</code> <p>Callable signature, if applicable.</p> <code>docstring</code> <code>Optional[str]</code> <p>Raw docstring content extracted from the source.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Dictionary mapping member names to their DocObject representations.</p> <p>Initialize a new DocObject.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The local name of the object.</p> required <code>kind</code> <code>str</code> <p>The kind of object (e.g., 'class', 'function').</p> required <code>path</code> <code>str</code> <p>The full dotted path to the object.</p> required <code>signature</code> <code>Optional[str]</code> <p>The object's signature (for callable objects).</p> <code>None</code> <code>docstring</code> <code>Optional[str]</code> <p>The object's docstring, if any.</p> <code>None</code>"},{"location":"models/object/#docforge.models.object.DocObject.add_member","title":"add_member","text":"<pre><code>add_member(obj: DocObject) -&gt; None\n</code></pre> <p>Add a child member to this object (e.g., a method to a class).</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>The child DocObject to add.</p> required"},{"location":"models/object/#docforge.models.object.DocObject.get_all_members","title":"get_all_members","text":"<pre><code>get_all_members() -&gt; Iterable[DocObject]\n</code></pre> <p>Get all members of this object.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of child DocObject instances.</p>"},{"location":"models/object/#docforge.models.object.DocObject.get_member","title":"get_member","text":"<pre><code>get_member(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a child member by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the member.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The requested DocObject.</p>"},{"location":"models/project/","title":"Project","text":""},{"location":"models/project/#docforge.models.project","title":"docforge.models.project","text":"<p>This module defines the Project class, the top-level container for a documented project. It aggregates multiple Module instances into a single named entity.</p>"},{"location":"models/project/#docforge.models.project.Project","title":"Project","text":"<pre><code>Project(name: str)\n</code></pre> <p>Represents a documentation project, serving as a container for modules.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Name of the project.</p> <code>modules</code> <code>Dict[str, Module]</code> <p>Dictionary mapping module paths to Module instances.</p> <p>Initialize a new Project.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>The name of the project.</p> required"},{"location":"models/project/#docforge.models.project.Project.add_module","title":"add_module","text":"<pre><code>add_module(module: Module) -&gt; None\n</code></pre> <p>Add a module to the project.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>Module</code> <p>The module to add.</p> required"},{"location":"models/project/#docforge.models.project.Project.get_all_modules","title":"get_all_modules","text":"<pre><code>get_all_modules() -&gt; Iterable[Module]\n</code></pre> <p>Get all modules in the project.</p> <p>Returns:</p> Type Description <code>Iterable[Module]</code> <p>An iterable of Module objects.</p>"},{"location":"models/project/#docforge.models.project.Project.get_module","title":"get_module","text":"<pre><code>get_module(path: str) -&gt; Module\n</code></pre> <p>Retrieve a module by its dotted path.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>The dotted path of the module (e.g., 'pkg.mod').</p> required <p>Returns:</p> Type Description <code>Module</code> <p>The requested Module.</p>"},{"location":"models/project/#docforge.models.project.Project.get_module_list","title":"get_module_list","text":"<pre><code>get_module_list() -&gt; list[str]\n</code></pre> <p>Get the list of all module dotted paths.</p> <p>Returns:</p> Type Description <code>list[str]</code> <p>A list of module paths.</p>"},{"location":"nav/","title":"Nav","text":""},{"location":"nav/#docforge.nav","title":"docforge.nav","text":""},{"location":"nav/#docforge.nav--navigation-layer","title":"Navigation Layer","text":"<p>The <code>docforge.nav</code> package manages the mapping between the logical documentation structure and the physical files on disk.</p>"},{"location":"nav/#docforge.nav--workflow","title":"Workflow","text":"<ol> <li>Spec Definition: Users define navigation intent in <code>docforge.nav.yml</code>.</li> <li>Resolution: <code>resolve_nav</code> matches patterns in the spec to generated <code>.md</code> files.</li> <li>Emission: <code>MkDocsNavEmitter</code> produces the final YAML structure for <code>mkdocs.yml</code>.</li> </ol> <p>This abstraction allows doc-forge to support complex grouping and ordering independently of the source code's physical layout.</p>"},{"location":"nav/#docforge.nav.MkDocsNavEmitter","title":"MkDocsNavEmitter","text":"<p>Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible navigation structure.</p>"},{"location":"nav/#docforge.nav.MkDocsNavEmitter.emit","title":"emit","text":"<pre><code>emit(nav: ResolvedNav) -&gt; List[Dict[str, Any]]\n</code></pre> <p>Generate a list of navigation entries for mkdocs.yml.</p> <p>Parameters:</p> Name Type Description Default <code>nav</code> <code>ResolvedNav</code> <p>The resolved navigation data.</p> required <p>Returns:</p> Type Description <code>List[Dict[str, Any]]</code> <p>A list of dictionary mappings representing the MkDocs navigation.</p>"},{"location":"nav/#docforge.nav.NavSpec","title":"NavSpec","text":"<pre><code>NavSpec(home: Optional[str], groups: Dict[str, List[str]])\n</code></pre> <p>Parsed representation of the docforge navigation specification file.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Path to the home document (e.g., 'index.md').</p> <code>groups</code> <code>Dict[str, List[str]]</code> <p>Mapping of group titles to lists of path patterns/globs.</p> <p>Initialize a NavSpec.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>Optional[str]</code> <p>The path to the home document.</p> required <code>groups</code> <code>Dict[str, List[str]]</code> <p>A mapping of group names to lists of path patterns (globs).</p> required"},{"location":"nav/#docforge.nav.NavSpec.all_patterns","title":"all_patterns","text":"<pre><code>all_patterns() -&gt; List[str]\n</code></pre> <p>Get all path patterns referenced in the specification.</p> <p>Returns:</p> Type Description <code>List[str]</code> <p>A list of all patterns (home plus all groups).</p>"},{"location":"nav/#docforge.nav.NavSpec.load","title":"load  <code>classmethod</code>","text":"<pre><code>load(path: Path) -&gt; NavSpec\n</code></pre> <p>Load a NavSpec from a YAML file.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>The filesystem path to the YAML file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A NavSpec instance.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the path does not exist.</p> <code>ValueError</code> <p>If the file content is not a valid NavSpec mapping.</p>"},{"location":"nav/#docforge.nav.ResolvedNav","title":"ResolvedNav","text":"<pre><code>ResolvedNav(home: str | None, groups: Dict[str, List[Path]], docs_root: Path | None = None)\n</code></pre> <p>Represents a navigation structure where all patterns and paths have been resolved against the actual filesystem contents.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Resolved relative path to the home page.</p> <code>groups</code> <code>Dict[str, List[Path]]</code> <p>Mapping of group titles to lists of absolute or relative Path objects.</p> <p>Initialize a ResolvedNav instance.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>str | None</code> <p>The relative path to the project home page.</p> required <code>groups</code> <code>Dict[str, List[Path]]</code> <p>A mapping of group names to their resolved filesystem paths.</p> required <code>docs_root</code> <code>Path | None</code> <p>The root documentation directory.</p> <code>None</code>"},{"location":"nav/#docforge.nav.ResolvedNav.all_files","title":"all_files","text":"<pre><code>all_files() -&gt; Iterable[Path]\n</code></pre> <p>Get an iterable of all resolved files in the navigation structure.</p> <p>Returns:</p> Type Description <code>Iterable[Path]</code> <p>An iterable of Path objects.</p>"},{"location":"nav/#docforge.nav.load_nav_spec","title":"load_nav_spec","text":"<pre><code>load_nav_spec(path: Path) -&gt; NavSpec\n</code></pre> <p>Utility function to load a NavSpec from a file.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>Path to the navigation specification file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A loaded NavSpec instance.</p>"},{"location":"nav/#docforge.nav.resolve_nav","title":"resolve_nav","text":"<pre><code>resolve_nav(spec: NavSpec, docs_root: Path) -&gt; ResolvedNav\n</code></pre> <p>Create a ResolvedNav by processing a NavSpec against the filesystem. This expands globs and validates the existence of referenced files.</p> <p>Parameters:</p> Name Type Description Default <code>spec</code> <code>NavSpec</code> <p>The navigation specification to resolve.</p> required <code>docs_root</code> <code>Path</code> <p>The root directory for documentation files.</p> required <p>Returns:</p> Type Description <code>ResolvedNav</code> <p>A ResolvedNav instance.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If a pattern doesn't match any files or the docs_root doesn't exist.</p>"},{"location":"nav/mkdocs/","title":"Mkdocs","text":""},{"location":"nav/mkdocs/#docforge.nav.mkdocs","title":"docforge.nav.mkdocs","text":"<p>This module provides the MkDocsNavEmitter, which converts a ResolvedNav instance into the specific YAML-ready list structure expected by the MkDocs 'nav' configuration.</p>"},{"location":"nav/mkdocs/#docforge.nav.mkdocs.MkDocsNavEmitter","title":"MkDocsNavEmitter","text":"<p>Emitter responsible for transforming a ResolvedNav into an MkDocs-compatible navigation structure.</p>"},{"location":"nav/mkdocs/#docforge.nav.mkdocs.MkDocsNavEmitter.emit","title":"emit","text":"<pre><code>emit(nav: ResolvedNav) -&gt; List[Dict[str, Any]]\n</code></pre> <p>Generate a list of navigation entries for mkdocs.yml.</p> <p>Parameters:</p> Name Type Description Default <code>nav</code> <code>ResolvedNav</code> <p>The resolved navigation data.</p> required <p>Returns:</p> Type Description <code>List[Dict[str, Any]]</code> <p>A list of dictionary mappings representing the MkDocs navigation.</p>"},{"location":"nav/resolver/","title":"Resolver","text":""},{"location":"nav/resolver/#docforge.nav.resolver","title":"docforge.nav.resolver","text":"<p>This module contains the logic for resolving a NavSpec against the physical filesystem. It expands globs and validates that all referenced documents actually exist on disk.</p>"},{"location":"nav/resolver/#docforge.nav.resolver.ResolvedNav","title":"ResolvedNav","text":"<pre><code>ResolvedNav(home: str | None, groups: Dict[str, List[Path]], docs_root: Path | None = None)\n</code></pre> <p>Represents a navigation structure where all patterns and paths have been resolved against the actual filesystem contents.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Resolved relative path to the home page.</p> <code>groups</code> <code>Dict[str, List[Path]]</code> <p>Mapping of group titles to lists of absolute or relative Path objects.</p> <p>Initialize a ResolvedNav instance.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>str | None</code> <p>The relative path to the project home page.</p> required <code>groups</code> <code>Dict[str, List[Path]]</code> <p>A mapping of group names to their resolved filesystem paths.</p> required <code>docs_root</code> <code>Path | None</code> <p>The root documentation directory.</p> <code>None</code>"},{"location":"nav/resolver/#docforge.nav.resolver.ResolvedNav.all_files","title":"all_files","text":"<pre><code>all_files() -&gt; Iterable[Path]\n</code></pre> <p>Get an iterable of all resolved files in the navigation structure.</p> <p>Returns:</p> Type Description <code>Iterable[Path]</code> <p>An iterable of Path objects.</p>"},{"location":"nav/resolver/#docforge.nav.resolver.resolve_nav","title":"resolve_nav","text":"<pre><code>resolve_nav(spec: NavSpec, docs_root: Path) -&gt; ResolvedNav\n</code></pre> <p>Create a ResolvedNav by processing a NavSpec against the filesystem. This expands globs and validates the existence of referenced files.</p> <p>Parameters:</p> Name Type Description Default <code>spec</code> <code>NavSpec</code> <p>The navigation specification to resolve.</p> required <code>docs_root</code> <code>Path</code> <p>The root directory for documentation files.</p> required <p>Returns:</p> Type Description <code>ResolvedNav</code> <p>A ResolvedNav instance.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If a pattern doesn't match any files or the docs_root doesn't exist.</p>"},{"location":"nav/spec/","title":"Spec","text":""},{"location":"nav/spec/#docforge.nav.spec","title":"docforge.nav.spec","text":"<p>This module defines the NavSpec class, which represents the user's intent for documentation navigation as defined in a YAML specification (usually docforge.nav.yml).</p>"},{"location":"nav/spec/#docforge.nav.spec.NavSpec","title":"NavSpec","text":"<pre><code>NavSpec(home: Optional[str], groups: Dict[str, List[str]])\n</code></pre> <p>Parsed representation of the docforge navigation specification file.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Path to the home document (e.g., 'index.md').</p> <code>groups</code> <code>Dict[str, List[str]]</code> <p>Mapping of group titles to lists of path patterns/globs.</p> <p>Initialize a NavSpec.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>Optional[str]</code> <p>The path to the home document.</p> required <code>groups</code> <code>Dict[str, List[str]]</code> <p>A mapping of group names to lists of path patterns (globs).</p> required"},{"location":"nav/spec/#docforge.nav.spec.NavSpec.all_patterns","title":"all_patterns","text":"<pre><code>all_patterns() -&gt; List[str]\n</code></pre> <p>Get all path patterns referenced in the specification.</p> <p>Returns:</p> Type Description <code>List[str]</code> <p>A list of all patterns (home plus all groups).</p>"},{"location":"nav/spec/#docforge.nav.spec.NavSpec.load","title":"load  <code>classmethod</code>","text":"<pre><code>load(path: Path) -&gt; NavSpec\n</code></pre> <p>Load a NavSpec from a YAML file.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>The filesystem path to the YAML file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A NavSpec instance.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the path does not exist.</p> <code>ValueError</code> <p>If the file content is not a valid NavSpec mapping.</p>"},{"location":"nav/spec/#docforge.nav.spec.load_nav_spec","title":"load_nav_spec","text":"<pre><code>load_nav_spec(path: Path) -&gt; NavSpec\n</code></pre> <p>Utility function to load a NavSpec from a file.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>Path to the navigation specification file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A loaded NavSpec instance.</p>"},{"location":"renderers/","title":"Renderers","text":""},{"location":"renderers/#docforge.renderers","title":"docforge.renderers","text":""},{"location":"renderers/#docforge.renderers--renderers-layer","title":"Renderers Layer","text":"<p>The <code>docforge.renderers</code> package handles the transformation of the internal documentation models into physical files formatted for specific documentation engines.</p>"},{"location":"renderers/#docforge.renderers--current-implementations","title":"Current Implementations","text":"<ul> <li>MkDocsRenderer: Generates Markdown files utilizing the <code>mkdocstrings</code>   syntax. It automatically handles package/module hierarchy and generates   <code>index.md</code> files for packages.</li> </ul>"},{"location":"renderers/#docforge.renderers--extending","title":"Extending","text":"<p>To add a new renderer, implement the <code>DocRenderer</code> protocol defined in <code>docforge.renderers.base</code>.</p>"},{"location":"renderers/#docforge.renderers.MCPRenderer","title":"MCPRenderer","text":"<p>Renderer that emits MCP-native JSON resources from docforge models.</p>"},{"location":"renderers/#docforge.renderers.MCPRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP-compatible JSON resources and navigation for the project.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project model to render.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for the generated JSON files.</p> required"},{"location":"renderers/#docforge.renderers.MkDocsRenderer","title":"MkDocsRenderer","text":"<p>Renderer that generates Markdown source files formatted for the MkDocs 'mkdocstrings' plugin.</p>"},{"location":"renderers/#docforge.renderers.MkDocsRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Produce a set of Markdown files in the output directory based on the provided Project models.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project models to render.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for documentation files.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Module is the source folder and to be treated as the root folder.</p> <code>None</code>"},{"location":"renderers/base/","title":"Base","text":""},{"location":"renderers/base/#docforge.renderers.base","title":"docforge.renderers.base","text":"<p>This module defines the base interfaces and configuration containers for doc-forge renderers. All renderer implementations should adhere to the DocRenderer protocol.</p>"},{"location":"renderers/base/#docforge.renderers.base.DocRenderer","title":"DocRenderer","text":"<p>               Bases: <code>Protocol</code></p> <p>Protocol defining the interface for documentation renderers.</p>"},{"location":"renderers/base/#docforge.renderers.base.DocRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate renderer-specific source files for the given project.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project models containing modules and objects.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for the generated files.</p> required"},{"location":"renderers/base/#docforge.renderers.base.RendererConfig","title":"RendererConfig","text":"<pre><code>RendererConfig(out_dir: Path, project: Project)\n</code></pre> <p>Configuration container for documentation renderers.</p> <p>Parameters:</p> Name Type Description Default <code>out_dir</code> <code>Path</code> <p>The directory where documentation files should be written.</p> required <code>project</code> <code>Project</code> <p>The introspected project models to be rendered.</p> required"},{"location":"renderers/mcp_renderer/","title":"Mcp Renderer","text":""},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer","title":"docforge.renderers.mcp_renderer","text":""},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer.MCPRenderer","title":"MCPRenderer","text":"<p>Renderer that emits MCP-native JSON resources from docforge models.</p>"},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer.MCPRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP-compatible JSON resources and navigation for the project.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project model to render.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for the generated JSON files.</p> required"},{"location":"renderers/mkdocs_renderer/","title":"Mkdocs Renderer","text":""},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer","title":"docforge.renderers.mkdocs_renderer","text":"<p>MkDocsRenderer</p> <p>Generates Markdown source files compatible with MkDocs Material and mkdocstrings, ensuring:</p> <ul> <li>Root index.md always exists</li> <li>Parent package indexes are created automatically</li> <li>Child modules are linked in parent index files</li> </ul>"},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer.MkDocsRenderer","title":"MkDocsRenderer","text":"<p>Renderer that generates Markdown source files formatted for the MkDocs 'mkdocstrings' plugin.</p>"},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Produce a set of Markdown files in the output directory based on the provided Project models.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>The project models to render.</p> required <code>out_dir</code> <code>Path</code> <p>Target directory for documentation files.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Module is the source folder and to be treated as the root folder.</p> <code>None</code>"},{"location":"servers/","title":"Servers","text":""},{"location":"servers/#docforge.servers","title":"docforge.servers","text":""},{"location":"servers/#docforge.servers.MCPServer","title":"MCPServer","text":"<pre><code>MCPServer(mcp_root: Path, name: str)\n</code></pre> <p>MCP server for serving a pre-built MCP documentation bundle.</p> <p>Initialize the MCPServer.</p> <p>Parameters:</p> Name Type Description Default <code>mcp_root</code> <code>Path</code> <p>Path to the directory containing pre-built MCP JSON resources.</p> required <code>name</code> <code>str</code> <p>Name of the MCP server.</p> required"},{"location":"servers/#docforge.servers.MCPServer.run","title":"run","text":"<pre><code>run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http') -&gt; None\n</code></pre> <p>Start the MCP server.</p> <p>Parameters:</p> Name Type Description Default <code>transport</code> <code>Literal['stdio', 'sse', 'streamable-http']</code> <p>MCP transport (default: streamable-http)</p> <code>'streamable-http'</code>"},{"location":"servers/mcp_server/","title":"Mcp Server","text":""},{"location":"servers/mcp_server/#docforge.servers.mcp_server","title":"docforge.servers.mcp_server","text":""},{"location":"servers/mcp_server/#docforge.servers.mcp_server.MCPServer","title":"MCPServer","text":"<pre><code>MCPServer(mcp_root: Path, name: str)\n</code></pre> <p>MCP server for serving a pre-built MCP documentation bundle.</p> <p>Initialize the MCPServer.</p> <p>Parameters:</p> Name Type Description Default <code>mcp_root</code> <code>Path</code> <p>Path to the directory containing pre-built MCP JSON resources.</p> required <code>name</code> <code>str</code> <p>Name of the MCP server.</p> required"},{"location":"servers/mcp_server/#docforge.servers.mcp_server.MCPServer.run","title":"run","text":"<pre><code>run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http') -&gt; None\n</code></pre> <p>Start the MCP server.</p> <p>Parameters:</p> Name Type Description Default <code>transport</code> <code>Literal['stdio', 'sse', 'streamable-http']</code> <p>MCP transport (default: streamable-http)</p> <code>'streamable-http'</code>"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"","title":"docforge","text":""},{"location":"#docforge","title":"docforge","text":"<p>Renderer-agnostic Python documentation compiler that converts Python docstrings into structured documentation for both humans (MkDocs) and machines (MCP / AI agents).</p> <p><code>doc-forge</code> statically analyzes source code, builds a semantic model of modules, classes, functions, and attributes, and renders that model into documentation outputs without executing user code.</p>"},{"location":"#docforge--installation","title":"Installation","text":"<p>Install using pip:</p> <pre><code>pip install doc-forge\n</code></pre>"},{"location":"#docforge--quick-start","title":"Quick start","text":"<p>Generate a MkDocs site from a Python package:</p> <pre><code>doc-forge build --mkdocs --module my_package\n</code></pre> <p>Generate MCP JSON documentation:</p> <pre><code>doc-forge build --mcp --module my_package\n</code></pre> <p>Serve documentation locally:</p> <pre><code>doc-forge serve --mkdocs --module my_package\n</code></pre>"},{"location":"#docforge--core-concepts","title":"Core concepts","text":"<p>Loader</p> <p>Extracts symbols, signatures, and docstrings using static analysis.</p> <p>Semantic model</p> <p>Structured, renderer-agnostic representation of the API.</p> <p>Renderer</p> <p>Converts the semantic model into output formats such as MkDocs or MCP JSON.</p> <p>Symbol</p> <p>Any documentable object:</p> <pre><code>- module\n- class\n- function\n- method\n- property\n- attribute\n</code></pre>"},{"location":"#docforge--architecture","title":"Architecture","text":"<p><code>doc-forge</code> follows a compiler architecture:</p> <p>Front-end:</p> <pre><code>Static analysis of modules, classes, functions, type hints, and docstrings.\n</code></pre> <p>Middle-end:</p> <pre><code>Builds a semantic model describing symbols and relationships.\n</code></pre> <p>Back-end:</p> <pre><code>Renders documentation using interchangeable renderers.\n</code></pre> <p>This architecture ensures deterministic documentation generation.</p>"},{"location":"#docforge--rendering-pipeline","title":"Rendering pipeline","text":"<p>Typical flow:</p> <pre><code>Python package\n    \u2193\nLoader (static analysis)\n    \u2193\nSemantic model\n    \u2193\nRenderer\n    \u2193\nMkDocs site or MCP JSON\n</code></pre>"},{"location":"#docforge--cli-usage","title":"CLI usage","text":"<p>Build MkDocs documentation:</p> <pre><code>doc-forge build --mkdocs --module my_package\n</code></pre> <p>Build MCP documentation:</p> <pre><code>doc-forge build --mcp --module my_package\n</code></pre> <p>Serve MkDocs locally:</p> <pre><code>doc-forge serve --module my_package\n</code></pre>"},{"location":"#docforge--public-api","title":"Public API","text":"<p>Loaders:</p> <pre><code>GriffeLoader\ndiscover_module_paths\n</code></pre> <p>Renderers:</p> <pre><code>MkDocsRenderer\nMCPRenderer\n</code></pre> <p>CLI:</p> <pre><code>main\n</code></pre> <p>Models:</p> <pre><code>models\n</code></pre>"},{"location":"#docforge--google-styled-doc-forge-convention-gsdfc","title":"Google-Styled Doc-Forge Convention (GSDFC)","text":"<p>GSDFC defines how docstrings must be written so they render correctly in MkDocs and remain machine-parsable by doc-forge and AI tooling.</p> <ul> <li>Docstrings are the single source of truth.</li> <li>doc-forge compiles docstrings but does not generate documentation content.</li> <li>Documentation follows the Python import hierarchy.</li> <li>Every public symbol should have a complete and accurate docstring.</li> </ul>"},{"location":"#docforge--general-rules","title":"General rules","text":"<ul> <li>Use Markdown headings at package and module level.</li> <li>Use Google-style structured sections at class, function, and method level.</li> <li>Indent section contents using four spaces.</li> <li>Use type hints in signatures instead of duplicating types in prose.</li> <li>Write summaries in imperative form.</li> <li>Sections are separated by <code>---</code></li> </ul>"},{"location":"#docforge--package-docstrings","title":"Package docstrings","text":"<ul> <li>Package docstrings act as the documentation home page.</li> </ul> <p>Recommended sections:</p> <pre><code>## Summary\n## Installation\n## Quick start\n## Core concepts\n## Architecture\n## Rendering pipeline\n## CLI usage\n## Public API\n## Examples\n## Notes\n</code></pre> Example <p>Package Doc String:</p> <pre><code>'''\nFoo-bar processing framework.\n\nProvides tools for defining Foo objects and executing Bar pipelines.\n\n---\n\n# Installation\n\n    pip install foo-bar\n\n---\n\n# Quick start\n\n    from foobar import Foo, BarEngine\n\n    foo = Foo(\"example\")\n    engine = BarEngine([foo])\n\n    result = engine.run()\n\n---\n\n# Public API\n\n    Foo\n    Bar\n    BarEngine\n\n---\n'''\n</code></pre>"},{"location":"#docforge--module-docstrings","title":"Module docstrings","text":"<ul> <li>Module docstrings describe a subsystem.</li> </ul> <p>Recommended sections:</p> <pre><code>## Summary\n## Examples\n## Notes\n## Public API\n</code></pre> Example <p>Module Doc String:</p> <pre><code>'''\nFoo execution subsystem.\n\nProvides utilities for executing Foo objects through Bar stages.\n\n---\n\nExample:\n\n    from foobar.engine import BarEngine\n    from foobar.foo import Foo\n\n    foo = Foo(\"example\")\n\n    engine = BarEngine([foo])\n    engine.run()\n\n---\n'''\n</code></pre>"},{"location":"#docforge--class-docstrings","title":"Class docstrings","text":"<ul> <li>Class docstrings define object responsibility, lifecycle, and attributes.</li> </ul> <p>Recommended sections:</p> <pre><code>Attributes:\nNotes:\nExample:\nRaises:\n</code></pre> Example <p>Simple Foo:</p> <pre><code>class Foo:\n    '''\n    Represents a unit of work.\n\n    Attributes:\n        name (str):\n            Identifier of the foo instance.\n\n        value (int):\n            Numeric value associated with foo.\n\n    Notes:\n        Guarantees:\n\n            - instances are immutable after creation\n\n        Lifecycle:\n\n            - create instance\n            - pass to processing engine\n\n    Example:\n        Create and inspect a Foo:\n\n            foo = Foo(\"example\", value=42)\n            print(foo.name)\n    '''\n</code></pre> <p>Complex Bar:</p> <pre><code>class BarEngine:\n    '''\n    Executes Foo objects through Bar stages.\n\n    Attributes:\n        foos (tuple[Foo, ...]):\n            Foo instances managed by the engine.\n\n    Notes:\n        Guarantees:\n\n            - deterministic execution order\n\n    Example:\n        Run engine:\n\n            foo1 = Foo(\"a\")\n            foo2 = Foo(\"b\")\n\n            engine = BarEngine([foo1, foo2])\n            engine.run()\n    '''\n</code></pre>"},{"location":"#docforge--function-and-method-docstrings","title":"Function and method docstrings","text":"<ul> <li>Function docstrings define API contracts.</li> </ul> <p>Recommended sections:</p> <pre><code>Args:\nReturns:\nRaises:\nYields:\nNotes:\nExample:\n</code></pre> Example <p>Simple process method:</p> <pre><code>def process(foo: Foo, multiplier: int) -&gt; int:\n    '''\n    Process a Foo instance.\n\n    Args:\n        foo (Foo):\n            Foo instance to process.\n\n        multiplier (int):\n            Value used to scale foo.\n\n    Returns:\n        int:\n            Processed result.\n\n    Raises:\n        ValueError:\n            If multiplier is negative.\n\n    Notes:\n        Guarantees:\n\n            - foo is not modified\n\n    Example:\n        Process foo:\n\n            foo = Foo(\"example\", value=10)\n\n            result = process(foo, multiplier=2)\n            print(result)\n    '''\n</code></pre> <p>Multiple Examples:</p> <pre><code>def combine(foo_a: Foo, foo_b: Foo) -&gt; Foo:\n    '''\n    Combine two Foo instances.\n\n    Args:\n        foo_a (Foo):\n            First foo.\n\n        foo_b (Foo):\n            Second foo.\n\n    Returns:\n        Foo:\n            Combined foo.\n\n    Example:\n        Basic usage:\n\n            foo1 = Foo(\"a\")\n            foo2 = Foo(\"b\")\n\n            combined = combine(foo1, foo2)\n\n        Pipeline usage:\n\n            engine = BarEngine([foo1, foo2])\n            engine.run()\n    '''\n</code></pre>"},{"location":"#docforge--property-docstrings","title":"Property docstrings","text":"<ul> <li>Properties must document return values.</li> </ul> Example <p>Property Doc String:</p> <pre><code>@property\ndef foos(self) -&gt; tuple[Foo, ...]:\n    '''\n    Return contained Foo instances.\n\n    Returns:\n        tuple[Foo, ...]:\n            Stored foo objects.\n\n    Example:\n        container = FooContainer()\n\n        foos = container.foos\n    '''\n</code></pre>"},{"location":"#docforge--attribute-documentation","title":"Attribute documentation","text":"<ul> <li>Document attributes in class docstrings using Attributes:.</li> </ul> Example <p>Attribute Doc String:</p> <pre><code>'''\nRepresents a processing stage.\n\nAttributes:\n    id (str):\n        Unique identifier.\n\n    enabled (bool):\n        Whether the stage is active.\n'''\n</code></pre>"},{"location":"#docforge--notes-subsection-grouping","title":"Notes subsection grouping","text":"<ul> <li>Group related information using labeled subsections.</li> </ul> Example <p>Notes Example:</p> <pre><code>Notes:\n    **Guarantees:**\n\n        - deterministic behavior\n\n    **Lifecycle:**\n\n        - created during initialization\n        - reused across executions\n\n    **Thread safety:**\n\n        - safe for concurrent reads\n</code></pre>"},{"location":"#docforge--example-formatting","title":"Example formatting","text":"<ul> <li>Use indentation for examples.</li> </ul> Example <p>Single example:</p> <pre><code>Example:\n\n    foo = Foo(\"example\")\n    process(foo, multiplier=2)\n</code></pre> <p>Multiple examples:</p> <pre><code>Example:\n    Create foo:\n\n        foo = Foo(\"example\")\n\n    Run engine:\n\n        engine = BarEngine([foo])\n        engine.run()\n</code></pre> <p>Avoid fenced code blocks inside structured sections.</p>"},{"location":"#docforge--separator-rules","title":"Separator rules","text":"<p>Use horizontal separators only at docstring root level to separate sections:</p> <pre><code>---\n</code></pre> <p>Allowed locations:</p> <ul> <li>package docstrings</li> <li>module docstrings</li> <li>major documentation sections</li> </ul> <p>Do not use separators inside code sections.</p>"},{"location":"#docforge--parsing-guarantees","title":"Parsing guarantees","text":"<p>GSDFC ensures doc-forge can deterministically extract:</p> <ul> <li>symbol kind (module, class, function, property, attribute)</li> <li>symbol name</li> <li>parameters</li> <li>return values</li> <li>attributes</li> <li>examples</li> <li>structured Notes subsections</li> </ul> <p>This enables:</p> <ul> <li>reliable MkDocs rendering</li> <li>deterministic MCP export</li> <li>accurate AI semantic interpretation</li> </ul> Notes <ul> <li>doc-forge never executes analyzed modules.</li> <li>Documentation is generated entirely through static analysis.</li> </ul>"},{"location":"#docforge-classes","title":"Classes","text":""},{"location":"#docforge.GriffeLoader","title":"GriffeLoader","text":"<pre><code>GriffeLoader()\n</code></pre> <p>Load Python modules using Griffe and convert them into doc-forge models.</p> <p>This loader uses the Griffe introspection engine to analyze Python source code and transform the extracted information into <code>Project</code>, <code>Module</code>, and <code>DocObject</code> instances used by doc-forge.</p> <p>Initialize the Griffe-backed loader.</p> <p>Creates an internal Griffe loader instance with dedicated collections for modules and source lines.</p>"},{"location":"#docforge.GriffeLoader-functions","title":"Functions","text":""},{"location":"#docforge.GriffeLoader.load_module","title":"load_module","text":"<pre><code>load_module(path: str) -&gt; Module\n</code></pre> <p>Load and convert a single Python module.</p> <p>The module is introspected using Griffe and then transformed into a doc-forge <code>Module</code> model.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> required <p>Returns:</p> Type Description <code>Module</code> <p>A populated <code>Module</code> instance.</p>"},{"location":"#docforge.GriffeLoader.load_project","title":"load_project","text":"<pre><code>load_project(module_paths: List[str], project_name: Optional[str] = None, skip_import_errors: bool = None) -&gt; Project\n</code></pre> <p>Load multiple modules and assemble them into a Project model.</p> <p>Each module path is introspected and converted into a <code>Module</code> instance. All modules are then aggregated into a single <code>Project</code> object.</p> <p>Parameters:</p> Name Type Description Default <code>module_paths</code> <code>List[str]</code> <p>List of dotted module import paths to load.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional override for the project name. Defaults to the top-level name of the first module.</p> <code>None</code> <code>skip_import_errors</code> <code>bool</code> <p>If True, modules that fail to load will be skipped instead of raising an error.</p> <code>None</code> <p>Returns:</p> Type Description <code>Project</code> <p>A populated <code>Project</code> instance containing the loaded modules.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If no module paths are provided.</p> <code>ImportError</code> <p>If a module fails to load and <code>skip_import_errors</code> is False.</p>"},{"location":"#docforge.MCPRenderer","title":"MCPRenderer","text":"<p>Renderer that generates MCP-compatible documentation resources.</p> <p>This renderer converts doc-forge project models into structured JSON resources suitable for consumption by systems implementing the Model Context Protocol (MCP).</p>"},{"location":"#docforge.MCPRenderer-functions","title":"Functions","text":""},{"location":"#docforge.MCPRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP documentation resources for a project.</p> <p>The renderer serializes each module into a JSON resource and produces supporting metadata files such as <code>nav.json</code> and <code>index.json</code>.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Documentation project model to render.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where MCP resources will be written.</p> required"},{"location":"#docforge.MkDocsRenderer","title":"MkDocsRenderer","text":"<p>Renderer that produces Markdown documentation for MkDocs.</p> <p>Generated pages use mkdocstrings directives to reference Python modules, allowing MkDocs to render API documentation dynamically.</p>"},{"location":"#docforge.MkDocsRenderer-functions","title":"Functions","text":""},{"location":"#docforge.MkDocsRenderer.generate_readme","title":"generate_readme","text":"<pre><code>generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate a <code>README.md</code> file from the root module docstring.</p> <p>Behavior:</p> <ul> <li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the   project root directory.</li> <li>If False, README generation is currently not implemented.</li> </ul> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing documentation metadata.</p> required <code>docs_dir</code> <code>Path</code> <p>Directory containing generated documentation sources.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Whether the module is treated as the project source root.</p> <code>None</code>"},{"location":"#docforge.MkDocsRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate Markdown documentation files for a project.</p> <p>This method renders a documentation structure from the provided project model and writes the resulting Markdown files to the specified output directory.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing modules to document.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where generated Markdown files will be written.</p> required <code>module_is_source</code> <code>bool | None</code> <p>If True, treat the specified module as the documentation root rather than nesting it inside a folder.</p> <code>None</code>"},{"location":"#docforge-functions","title":"Functions","text":""},{"location":"#docforge.discover_module_paths","title":"discover_module_paths","text":"<pre><code>discover_module_paths(module_name: str, project_root: Path | None = None) -&gt; List[str]\n</code></pre> <p>Discover Python modules within a package directory.</p> <p>The function scans the filesystem for <code>.py</code> files inside the specified package and converts them into dotted module import paths.</p> <p>Discovery rules:</p> <ul> <li>Directories containing <code>__init__.py</code> are treated as packages.</li> <li>Each <code>.py</code> file is treated as a module.</li> <li>Results are returned as dotted import paths.</li> </ul> <p>Parameters:</p> Name Type Description Default <code>module_name</code> <code>str</code> <p>Top-level package name to discover modules from.</p> required <code>project_root</code> <code>Path | None</code> <p>Root directory used to resolve module paths. If not provided, the current working directory is used.</p> <code>None</code> <p>Returns:</p> Type Description <code>List[str]</code> <p>A sorted list of unique dotted module import paths.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specified package directory does not exist.</p>"},{"location":"cli/","title":"Cli","text":""},{"location":"cli/#docforge.cli","title":"docforge.cli","text":"<p>Command line interface entry point for doc-forge.</p> <p>This module exposes the primary CLI entry function used by the <code>doc-forge</code> command. The actual command implementation resides in <code>docforge.cli.main</code>, while this module provides a stable import path for external tools and the package entry point configuration.</p> <p>The CLI is responsible for orchestrating documentation workflows such as generating renderer sources, building documentation sites, exporting machine-readable documentation bundles, and starting development or MCP servers.</p>"},{"location":"cli/#docforge.cli--typical-usage","title":"Typical usage","text":"<p>The CLI is normally invoked through the installed command:</p> <pre><code>doc-forge &lt;command&gt; [options]\n</code></pre> <p>Programmatic invocation is also possible:</p> <pre><code>from docforge.cli import main\nmain()\n</code></pre>"},{"location":"cli/commands/","title":"Commands","text":""},{"location":"cli/commands/#docforge.cli.commands","title":"docforge.cli.commands","text":""},{"location":"cli/commands/#docforge.cli.commands-classes","title":"Classes","text":""},{"location":"cli/commands/#docforge.cli.commands-functions","title":"Functions","text":""},{"location":"cli/commands/#docforge.cli.commands.build","title":"build","text":"<pre><code>build(mcp: bool, mkdocs: bool, module_is_source: bool, module: Optional[str], project_name: Optional[str], site_name: Optional[str], docs_dir: Path, nav_file: Path, template: Optional[Path], mkdocs_yml: Path, out_dir: Path) -&gt; None\n</code></pre> <p>Build documentation artifacts.</p> <p>This command performs the full documentation build pipeline:</p> <ol> <li>Introspects the Python project using Griffe</li> <li>Generates renderer-specific documentation sources</li> <li>Optionally builds the final documentation output</li> </ol> <p>Depending on the selected options, the build can target:</p> <ul> <li>MkDocs static documentation sites</li> <li>MCP structured documentation resources</li> </ul> <p>Parameters:</p> Name Type Description Default <code>mcp</code> <code>bool</code> <p>Enable MCP documentation generation.</p> required <code>mkdocs</code> <code>bool</code> <p>Enable MkDocs documentation generation.</p> required <code>module_is_source</code> <code>bool</code> <p>Treat the specified module directory as the project root.</p> required <code>module</code> <code>Optional[str]</code> <p>Python module import path to document.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional override for the project name.</p> required <code>site_name</code> <code>Optional[str]</code> <p>Display name for the MkDocs site.</p> required <code>docs_dir</code> <code>Path</code> <p>Directory where Markdown documentation sources will be generated.</p> required <code>nav_file</code> <code>Path</code> <p>Path to the navigation specification file.</p> required <code>template</code> <code>Optional[Path]</code> <p>Optional custom MkDocs configuration template.</p> required <code>mkdocs_yml</code> <code>Path</code> <p>Output path for the generated MkDocs configuration.</p> required <code>out_dir</code> <code>Path</code> <p>Output directory for generated MCP resources.</p> required <p>Raises:</p> Type Description <code>UsageError</code> <p>If required options are missing or conflicting.</p>"},{"location":"cli/commands/#docforge.cli.commands.serve","title":"serve","text":"<pre><code>serve(mcp: bool, mkdocs: bool, module: Optional[str], mkdocs_yml: Path, out_dir: Path) -&gt; None\n</code></pre> <p>Serve generated documentation locally.</p> <p>Depending on the selected mode, this command starts either:</p> <ul> <li>A MkDocs development server for browsing documentation</li> <li>An MCP server exposing structured documentation resources</li> </ul> <p>Parameters:</p> Name Type Description Default <code>mcp</code> <code>bool</code> <p>Serve documentation using the MCP server.</p> required <code>mkdocs</code> <code>bool</code> <p>Serve the MkDocs development site.</p> required <code>module</code> <code>Optional[str]</code> <p>Python module import path to serve via MCP.</p> required <code>mkdocs_yml</code> <code>Path</code> <p>Path to the MkDocs configuration file.</p> required <code>out_dir</code> <code>Path</code> <p>Root directory containing MCP documentation resources.</p> required <p>Raises:</p> Type Description <code>UsageError</code> <p>If invalid or conflicting options are provided.</p>"},{"location":"cli/commands/#docforge.cli.commands.tree","title":"tree","text":"<pre><code>tree(module: str, project_name: Optional[str]) -&gt; None\n</code></pre> <p>Display the documentation object tree for a module.</p> <p>This command introspects the specified module and prints a hierarchical representation of the discovered documentation objects, including modules, classes, functions, and members.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>Python module import path to introspect.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional name to display as the project root.</p> required"},{"location":"cli/main/","title":"Main","text":""},{"location":"cli/main/#docforge.cli.main","title":"docforge.cli.main","text":"<p>Command-line entry point for the doc-forge CLI.</p> <p>This module exposes the executable entry point that initializes the Click command group defined in <code>docforge.cli.commands</code>.</p>"},{"location":"cli/main/#docforge.cli.main-functions","title":"Functions","text":""},{"location":"cli/main/#docforge.cli.main.main","title":"main","text":"<pre><code>main() -&gt; None\n</code></pre> <p>Run the doc-forge command-line interface.</p> <p>This function initializes and executes the Click CLI application. It is used as the console entry point when invoking <code>doc-forge</code> from the command line.</p>"},{"location":"cli/mcp_utils/","title":"Mcp Utils","text":""},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils","title":"docforge.cli.mcp_utils","text":""},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils-classes","title":"Classes","text":""},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils-functions","title":"Functions","text":""},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils.generate_resources","title":"generate_resources","text":"<pre><code>generate_resources(module: str, project_name: str | None, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP documentation resources from a Python module.</p> <p>The function performs project introspection, builds the internal documentation model, and renders MCP-compatible JSON resources to the specified output directory.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>Python module import path used as the entry point for documentation generation.</p> required <code>project_name</code> <code>str | None</code> <p>Optional override for the project name used in generated documentation metadata.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where MCP resources (index.json, nav.json, and module data) will be written.</p> required"},{"location":"cli/mcp_utils/#docforge.cli.mcp_utils.serve","title":"serve","text":"<pre><code>serve(module: str, mcp_root: Path) -&gt; None\n</code></pre> <p>Start an MCP server for a pre-generated documentation bundle.</p> <p>The server exposes documentation resources such as project metadata, navigation structure, and module documentation through MCP endpoints.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>Python module import path used to identify the served documentation instance.</p> required <code>mcp_root</code> <code>Path</code> <p>Path to the directory containing the MCP documentation bundle (index.json, nav.json, and modules/).</p> required <p>Raises:</p> Type Description <code>ClickException</code> <p>If the MCP documentation bundle is missing required files or directories.</p>"},{"location":"cli/mkdocs_utils/","title":"Mkdocs Utils","text":""},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils","title":"docforge.cli.mkdocs_utils","text":""},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils-classes","title":"Classes","text":""},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils-functions","title":"Functions","text":""},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.build","title":"build","text":"<pre><code>build(mkdocs_yml: Path) -&gt; None\n</code></pre> <p>Build the MkDocs documentation site.</p> <p>This function loads the MkDocs configuration and runs the MkDocs build command to generate the final static documentation site.</p> <p>Parameters:</p> Name Type Description Default <code>mkdocs_yml</code> <code>Path</code> <p>Path to the <code>mkdocs.yml</code> configuration file.</p> required <p>Raises:</p> Type Description <code>ClickException</code> <p>If the configuration file does not exist.</p>"},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.generate_config","title":"generate_config","text":"<pre><code>generate_config(docs_dir: Path, nav_file: Path, template: Path | None, out: Path, site_name: str) -&gt; None\n</code></pre> <p>Generate an <code>mkdocs.yml</code> configuration file.</p> <p>The configuration is created by combining a template configuration with a navigation structure derived from the docforge navigation specification.</p> <p>Parameters:</p> Name Type Description Default <code>docs_dir</code> <code>Path</code> <p>Directory containing generated documentation Markdown files.</p> required <code>nav_file</code> <code>Path</code> <p>Path to the <code>docforge.nav.yml</code> navigation specification.</p> required <code>template</code> <code>Path | None</code> <p>Optional path to a custom MkDocs configuration template. If not provided, a built-in template will be used.</p> required <code>out</code> <code>Path</code> <p>Destination path where the generated <code>mkdocs.yml</code> file will be written.</p> required <code>site_name</code> <code>str</code> <p>Display name for the generated documentation site.</p> required <p>Raises:</p> Type Description <code>FileError</code> <p>If the navigation specification or template file cannot be found.</p>"},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(module: str, docs_dir: Path, project_name: str | None = None, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate MkDocs Markdown sources for a Python module.</p> <p>This function introspects the specified module, builds the internal documentation model, and renders Markdown documentation files for use with MkDocs.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>str</code> <p>Python module import path used as the entry point for documentation generation.</p> required <code>docs_dir</code> <code>Path</code> <p>Directory where the generated Markdown files will be written.</p> required <code>project_name</code> <code>str | None</code> <p>Optional override for the project name used in documentation metadata.</p> <code>None</code> <code>module_is_source</code> <code>bool | None</code> <p>If True, treat the specified module directory as the project root rather than a nested module.</p> <code>None</code>"},{"location":"cli/mkdocs_utils/#docforge.cli.mkdocs_utils.serve","title":"serve","text":"<pre><code>serve(mkdocs_yml: Path) -&gt; None\n</code></pre> <p>Start an MkDocs development server with live reload.</p> <p>The server watches documentation files and automatically reloads the site when changes are detected.</p> <p>Parameters:</p> Name Type Description Default <code>mkdocs_yml</code> <code>Path</code> <p>Path to the <code>mkdocs.yml</code> configuration file.</p> required <p>Raises:</p> Type Description <code>ClickException</code> <p>If the configuration file does not exist.</p>"},{"location":"loaders/","title":"Loaders","text":""},{"location":"loaders/#docforge.loaders","title":"docforge.loaders","text":"<p>Loader layer for doc-forge.</p> <p>The <code>docforge.loaders</code> package is responsible for discovering Python modules and extracting documentation data using static analysis.</p>"},{"location":"loaders/#docforge.loaders--overview","title":"Overview","text":"<p>This layer converts Python source code into an intermediate documentation model used by doc-forge. It performs module discovery, introspection, and initial filtering before the data is passed to the core documentation models.</p> <p>Core capabilities include:</p> <ul> <li>Module discovery \u2013 Locate Python modules and packages within a project.</li> <li>Static introspection \u2013 Parse docstrings, signatures, and object   hierarchies using the <code>griffe</code> library without executing the code.</li> <li>Public API filtering \u2013 Exclude private members (names prefixed with   <code>_</code>) to produce clean public documentation structures.</li> </ul>"},{"location":"loaders/#docforge.loaders-classes","title":"Classes","text":""},{"location":"loaders/#docforge.loaders.GriffeLoader","title":"GriffeLoader","text":"<pre><code>GriffeLoader()\n</code></pre> <p>Load Python modules using Griffe and convert them into doc-forge models.</p> <p>This loader uses the Griffe introspection engine to analyze Python source code and transform the extracted information into <code>Project</code>, <code>Module</code>, and <code>DocObject</code> instances used by doc-forge.</p> <p>Initialize the Griffe-backed loader.</p> <p>Creates an internal Griffe loader instance with dedicated collections for modules and source lines.</p>"},{"location":"loaders/#docforge.loaders.GriffeLoader-functions","title":"Functions","text":""},{"location":"loaders/#docforge.loaders.GriffeLoader.load_module","title":"load_module","text":"<pre><code>load_module(path: str) -&gt; Module\n</code></pre> <p>Load and convert a single Python module.</p> <p>The module is introspected using Griffe and then transformed into a doc-forge <code>Module</code> model.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> required <p>Returns:</p> Type Description <code>Module</code> <p>A populated <code>Module</code> instance.</p>"},{"location":"loaders/#docforge.loaders.GriffeLoader.load_project","title":"load_project","text":"<pre><code>load_project(module_paths: List[str], project_name: Optional[str] = None, skip_import_errors: bool = None) -&gt; Project\n</code></pre> <p>Load multiple modules and assemble them into a Project model.</p> <p>Each module path is introspected and converted into a <code>Module</code> instance. All modules are then aggregated into a single <code>Project</code> object.</p> <p>Parameters:</p> Name Type Description Default <code>module_paths</code> <code>List[str]</code> <p>List of dotted module import paths to load.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional override for the project name. Defaults to the top-level name of the first module.</p> <code>None</code> <code>skip_import_errors</code> <code>bool</code> <p>If True, modules that fail to load will be skipped instead of raising an error.</p> <code>None</code> <p>Returns:</p> Type Description <code>Project</code> <p>A populated <code>Project</code> instance containing the loaded modules.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If no module paths are provided.</p> <code>ImportError</code> <p>If a module fails to load and <code>skip_import_errors</code> is False.</p>"},{"location":"loaders/#docforge.loaders-functions","title":"Functions","text":""},{"location":"loaders/#docforge.loaders.discover_module_paths","title":"discover_module_paths","text":"<pre><code>discover_module_paths(module_name: str, project_root: Path | None = None) -&gt; List[str]\n</code></pre> <p>Discover Python modules within a package directory.</p> <p>The function scans the filesystem for <code>.py</code> files inside the specified package and converts them into dotted module import paths.</p> <p>Discovery rules:</p> <ul> <li>Directories containing <code>__init__.py</code> are treated as packages.</li> <li>Each <code>.py</code> file is treated as a module.</li> <li>Results are returned as dotted import paths.</li> </ul> <p>Parameters:</p> Name Type Description Default <code>module_name</code> <code>str</code> <p>Top-level package name to discover modules from.</p> required <code>project_root</code> <code>Path | None</code> <p>Root directory used to resolve module paths. If not provided, the current working directory is used.</p> <code>None</code> <p>Returns:</p> Type Description <code>List[str]</code> <p>A sorted list of unique dotted module import paths.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specified package directory does not exist.</p>"},{"location":"loaders/griffe_loader/","title":"Griffe Loader","text":""},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader","title":"docforge.loaders.griffe_loader","text":"<p>Utilities for loading and introspecting Python modules using Griffe.</p> <p>This module provides the <code>GriffeLoader</code> class and helper utilities used to discover Python modules, introspect their structure, and convert the results into doc-forge documentation models.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader-classes","title":"Classes","text":""},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader","title":"GriffeLoader","text":"<pre><code>GriffeLoader()\n</code></pre> <p>Load Python modules using Griffe and convert them into doc-forge models.</p> <p>This loader uses the Griffe introspection engine to analyze Python source code and transform the extracted information into <code>Project</code>, <code>Module</code>, and <code>DocObject</code> instances used by doc-forge.</p> <p>Initialize the Griffe-backed loader.</p> <p>Creates an internal Griffe loader instance with dedicated collections for modules and source lines.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader-functions","title":"Functions","text":""},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader.load_module","title":"load_module","text":"<pre><code>load_module(path: str) -&gt; Module\n</code></pre> <p>Load and convert a single Python module.</p> <p>The module is introspected using Griffe and then transformed into a doc-forge <code>Module</code> model.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> required <p>Returns:</p> Type Description <code>Module</code> <p>A populated <code>Module</code> instance.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.GriffeLoader.load_project","title":"load_project","text":"<pre><code>load_project(module_paths: List[str], project_name: Optional[str] = None, skip_import_errors: bool = None) -&gt; Project\n</code></pre> <p>Load multiple modules and assemble them into a Project model.</p> <p>Each module path is introspected and converted into a <code>Module</code> instance. All modules are then aggregated into a single <code>Project</code> object.</p> <p>Parameters:</p> Name Type Description Default <code>module_paths</code> <code>List[str]</code> <p>List of dotted module import paths to load.</p> required <code>project_name</code> <code>Optional[str]</code> <p>Optional override for the project name. Defaults to the top-level name of the first module.</p> <code>None</code> <code>skip_import_errors</code> <code>bool</code> <p>If True, modules that fail to load will be skipped instead of raising an error.</p> <code>None</code> <p>Returns:</p> Type Description <code>Project</code> <p>A populated <code>Project</code> instance containing the loaded modules.</p> <p>Raises:</p> Type Description <code>ValueError</code> <p>If no module paths are provided.</p> <code>ImportError</code> <p>If a module fails to load and <code>skip_import_errors</code> is False.</p>"},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader-functions","title":"Functions","text":""},{"location":"loaders/griffe_loader/#docforge.loaders.griffe_loader.discover_module_paths","title":"discover_module_paths","text":"<pre><code>discover_module_paths(module_name: str, project_root: Path | None = None) -&gt; List[str]\n</code></pre> <p>Discover Python modules within a package directory.</p> <p>The function scans the filesystem for <code>.py</code> files inside the specified package and converts them into dotted module import paths.</p> <p>Discovery rules:</p> <ul> <li>Directories containing <code>__init__.py</code> are treated as packages.</li> <li>Each <code>.py</code> file is treated as a module.</li> <li>Results are returned as dotted import paths.</li> </ul> <p>Parameters:</p> Name Type Description Default <code>module_name</code> <code>str</code> <p>Top-level package name to discover modules from.</p> required <code>project_root</code> <code>Path | None</code> <p>Root directory used to resolve module paths. If not provided, the current working directory is used.</p> <code>None</code> <p>Returns:</p> Type Description <code>List[str]</code> <p>A sorted list of unique dotted module import paths.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specified package directory does not exist.</p>"},{"location":"models/","title":"Models","text":""},{"location":"models/#docforge.models","title":"docforge.models","text":"<p>Model layer for doc-forge.</p> <p>The <code>docforge.models</code> package defines the core data structures used to represent Python source code as a structured documentation model.</p>"},{"location":"models/#docforge.models--overview","title":"Overview","text":"<p>The model layer forms the central intermediate representation used throughout doc-forge. Python modules and objects discovered during introspection are converted into a hierarchy of documentation models that can later be rendered into different documentation formats.</p> <p>Key components:</p> <ul> <li>Project \u2013 Root container representing an entire documented codebase.</li> <li>Module \u2013 Representation of a Python module or package containing   documented members.</li> <li>DocObject \u2013 Recursive structure representing Python objects such as   classes, functions, methods, and attributes.</li> </ul> <p>These models are intentionally renderer-agnostic, allowing the same documentation structure to be transformed into multiple output formats (e.g., MkDocs, MCP, or other renderers).</p>"},{"location":"models/#docforge.models-classes","title":"Classes","text":""},{"location":"models/#docforge.models.DocObject","title":"DocObject","text":"<pre><code>DocObject(name: str, kind: str, path: str, signature: Optional[str] = None, docstring: Optional[str] = None)\n</code></pre> <p>Representation of a documented Python object.</p> <p>A <code>DocObject</code> models a single Python entity discovered during introspection. Objects may contain nested members, allowing the structure of modules, classes, and other containers to be represented recursively.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Local name of the object.</p> <code>kind</code> <code>str</code> <p>Type of object (for example <code>class</code>, <code>function</code>, <code>method</code>, or <code>attribute</code>).</p> <code>path</code> <code>str</code> <p>Fully qualified dotted path to the object.</p> <code>signature</code> <code>Optional[str]</code> <p>Callable signature if the object represents a callable.</p> <code>docstring</code> <code>Optional[str]</code> <p>Raw docstring text extracted from the source code.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Mapping of member names to child <code>DocObject</code> instances.</p> <p>Initialize a DocObject instance.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Local name of the object.</p> required <code>kind</code> <code>str</code> <p>Object type identifier (for example <code>class</code> or <code>function</code>).</p> required <code>path</code> <code>str</code> <p>Fully qualified dotted path of the object.</p> required <code>signature</code> <code>Optional[str]</code> <p>Callable signature if applicable.</p> <code>None</code> <code>docstring</code> <code>Optional[str]</code> <p>Documentation string associated with the object.</p> <code>None</code>"},{"location":"models/#docforge.models.DocObject-functions","title":"Functions","text":""},{"location":"models/#docforge.models.DocObject.add_member","title":"add_member","text":"<pre><code>add_member(obj: DocObject) -&gt; None\n</code></pre> <p>Add a child documentation object.</p> <p>This is typically used when attaching methods to classes or nested objects to their parent containers.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>Documentation object to add as a member.</p> required"},{"location":"models/#docforge.models.DocObject.get_all_members","title":"get_all_members","text":"<pre><code>get_all_members() -&gt; Iterable[DocObject]\n</code></pre> <p>Return all child members of the object.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of <code>DocObject</code> instances representing nested members.</p>"},{"location":"models/#docforge.models.DocObject.get_member","title":"get_member","text":"<pre><code>get_member(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a member object by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Name of the member to retrieve.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The corresponding <code>DocObject</code> instance.</p> <p>Raises:</p> Type Description <code>KeyError</code> <p>If the member does not exist.</p>"},{"location":"models/#docforge.models.Module","title":"Module","text":"<pre><code>Module(path: str, docstring: Optional[str] = None)\n</code></pre> <p>Representation of a documented Python module or package.</p> <p>A <code>Module</code> stores metadata about the module itself and maintains a collection of top-level documentation objects discovered during introspection.</p> <p>Attributes:</p> Name Type Description <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> <code>docstring</code> <code>Optional[str]</code> <p>Module-level documentation string, if present.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Mapping of object names to their corresponding <code>DocObject</code> representations.</p> <p>Initialize a Module instance.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Dotted import path identifying the module.</p> required <code>docstring</code> <code>Optional[str]</code> <p>Module-level documentation text, if available.</p> <code>None</code>"},{"location":"models/#docforge.models.Module-functions","title":"Functions","text":""},{"location":"models/#docforge.models.Module.add_object","title":"add_object","text":"<pre><code>add_object(obj: DocObject) -&gt; None\n</code></pre> <p>Add a documented object to the module.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>Documentation object to register as a top-level member of the module.</p> required"},{"location":"models/#docforge.models.Module.get_all_objects","title":"get_all_objects","text":"<pre><code>get_all_objects() -&gt; Iterable[DocObject]\n</code></pre> <p>Return all top-level documentation objects in the module.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of <code>DocObject</code> instances representing the</p> <code>Iterable[DocObject]</code> <p>module's public members.</p>"},{"location":"models/#docforge.models.Module.get_object","title":"get_object","text":"<pre><code>get_object(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a documented object by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Name of the object to retrieve.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The corresponding <code>DocObject</code> instance.</p> <p>Raises:</p> Type Description <code>KeyError</code> <p>If no object with the given name exists.</p>"},{"location":"models/#docforge.models.Project","title":"Project","text":"<pre><code>Project(name: str)\n</code></pre> <p>Representation of a documentation project.</p> <p>A <code>Project</code> serves as the root container for all modules discovered during introspection. Each module is stored by its dotted import path.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Name of the project.</p> <code>modules</code> <code>Dict[str, Module]</code> <p>Mapping of module paths to <code>Module</code> instances.</p> <p>Initialize a Project instance.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Name used to identify the documentation project.</p> required"},{"location":"models/#docforge.models.Project-functions","title":"Functions","text":""},{"location":"models/#docforge.models.Project.add_module","title":"add_module","text":"<pre><code>add_module(module: Module) -&gt; None\n</code></pre> <p>Register a module in the project.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>Module</code> <p>Module instance to add to the project.</p> required"},{"location":"models/#docforge.models.Project.get_all_modules","title":"get_all_modules","text":"<pre><code>get_all_modules() -&gt; Iterable[Module]\n</code></pre> <p>Return all modules contained in the project.</p> <p>Returns:</p> Type Description <code>Iterable[Module]</code> <p>An iterable of <code>Module</code> instances.</p>"},{"location":"models/#docforge.models.Project.get_module","title":"get_module","text":"<pre><code>get_module(path: str) -&gt; Module\n</code></pre> <p>Retrieve a module by its dotted path.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Fully qualified dotted module path (for example <code>pkg.module</code>).</p> required <p>Returns:</p> Type Description <code>Module</code> <p>The corresponding <code>Module</code> instance.</p> <p>Raises:</p> Type Description <code>KeyError</code> <p>If the module does not exist in the project.</p>"},{"location":"models/#docforge.models.Project.get_module_list","title":"get_module_list","text":"<pre><code>get_module_list() -&gt; list[str]\n</code></pre> <p>Return the list of module import paths.</p> <p>Returns:</p> Type Description <code>list[str]</code> <p>A list containing the dotted paths of all modules in the project.</p>"},{"location":"models/module/","title":"Module","text":""},{"location":"models/module/#docforge.models.module","title":"docforge.models.module","text":"<p>Documentation model representing a Python module or package.</p> <p>This module defines the <code>Module</code> class used in the doc-forge documentation model. A <code>Module</code> acts as a container for top-level documented objects (classes, functions, variables, and other members) discovered during introspection.</p>"},{"location":"models/module/#docforge.models.module-classes","title":"Classes","text":""},{"location":"models/module/#docforge.models.module.Module","title":"Module","text":"<pre><code>Module(path: str, docstring: Optional[str] = None)\n</code></pre> <p>Representation of a documented Python module or package.</p> <p>A <code>Module</code> stores metadata about the module itself and maintains a collection of top-level documentation objects discovered during introspection.</p> <p>Attributes:</p> Name Type Description <code>path</code> <code>str</code> <p>Dotted import path of the module.</p> <code>docstring</code> <code>Optional[str]</code> <p>Module-level documentation string, if present.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Mapping of object names to their corresponding <code>DocObject</code> representations.</p> <p>Initialize a Module instance.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Dotted import path identifying the module.</p> required <code>docstring</code> <code>Optional[str]</code> <p>Module-level documentation text, if available.</p> <code>None</code>"},{"location":"models/module/#docforge.models.module.Module-functions","title":"Functions","text":""},{"location":"models/module/#docforge.models.module.Module.add_object","title":"add_object","text":"<pre><code>add_object(obj: DocObject) -&gt; None\n</code></pre> <p>Add a documented object to the module.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>Documentation object to register as a top-level member of the module.</p> required"},{"location":"models/module/#docforge.models.module.Module.get_all_objects","title":"get_all_objects","text":"<pre><code>get_all_objects() -&gt; Iterable[DocObject]\n</code></pre> <p>Return all top-level documentation objects in the module.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of <code>DocObject</code> instances representing the</p> <code>Iterable[DocObject]</code> <p>module's public members.</p>"},{"location":"models/module/#docforge.models.module.Module.get_object","title":"get_object","text":"<pre><code>get_object(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a documented object by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Name of the object to retrieve.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The corresponding <code>DocObject</code> instance.</p> <p>Raises:</p> Type Description <code>KeyError</code> <p>If no object with the given name exists.</p>"},{"location":"models/object/","title":"Object","text":""},{"location":"models/object/#docforge.models.object","title":"docforge.models.object","text":"<p>Documentation model representing individual Python objects.</p> <p>This module defines the <code>DocObject</code> class, the fundamental recursive unit of the doc-forge documentation model. Each <code>DocObject</code> represents a Python entity such as a class, function, method, or attribute, and may contain nested members that form a hierarchical documentation structure.</p>"},{"location":"models/object/#docforge.models.object-classes","title":"Classes","text":""},{"location":"models/object/#docforge.models.object.DocObject","title":"DocObject","text":"<pre><code>DocObject(name: str, kind: str, path: str, signature: Optional[str] = None, docstring: Optional[str] = None)\n</code></pre> <p>Representation of a documented Python object.</p> <p>A <code>DocObject</code> models a single Python entity discovered during introspection. Objects may contain nested members, allowing the structure of modules, classes, and other containers to be represented recursively.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Local name of the object.</p> <code>kind</code> <code>str</code> <p>Type of object (for example <code>class</code>, <code>function</code>, <code>method</code>, or <code>attribute</code>).</p> <code>path</code> <code>str</code> <p>Fully qualified dotted path to the object.</p> <code>signature</code> <code>Optional[str]</code> <p>Callable signature if the object represents a callable.</p> <code>docstring</code> <code>Optional[str]</code> <p>Raw docstring text extracted from the source code.</p> <code>members</code> <code>Dict[str, DocObject]</code> <p>Mapping of member names to child <code>DocObject</code> instances.</p> <p>Initialize a DocObject instance.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Local name of the object.</p> required <code>kind</code> <code>str</code> <p>Object type identifier (for example <code>class</code> or <code>function</code>).</p> required <code>path</code> <code>str</code> <p>Fully qualified dotted path of the object.</p> required <code>signature</code> <code>Optional[str]</code> <p>Callable signature if applicable.</p> <code>None</code> <code>docstring</code> <code>Optional[str]</code> <p>Documentation string associated with the object.</p> <code>None</code>"},{"location":"models/object/#docforge.models.object.DocObject-functions","title":"Functions","text":""},{"location":"models/object/#docforge.models.object.DocObject.add_member","title":"add_member","text":"<pre><code>add_member(obj: DocObject) -&gt; None\n</code></pre> <p>Add a child documentation object.</p> <p>This is typically used when attaching methods to classes or nested objects to their parent containers.</p> <p>Parameters:</p> Name Type Description Default <code>obj</code> <code>DocObject</code> <p>Documentation object to add as a member.</p> required"},{"location":"models/object/#docforge.models.object.DocObject.get_all_members","title":"get_all_members","text":"<pre><code>get_all_members() -&gt; Iterable[DocObject]\n</code></pre> <p>Return all child members of the object.</p> <p>Returns:</p> Type Description <code>Iterable[DocObject]</code> <p>An iterable of <code>DocObject</code> instances representing nested members.</p>"},{"location":"models/object/#docforge.models.object.DocObject.get_member","title":"get_member","text":"<pre><code>get_member(name: str) -&gt; DocObject\n</code></pre> <p>Retrieve a member object by name.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Name of the member to retrieve.</p> required <p>Returns:</p> Type Description <code>DocObject</code> <p>The corresponding <code>DocObject</code> instance.</p> <p>Raises:</p> Type Description <code>KeyError</code> <p>If the member does not exist.</p>"},{"location":"models/project/","title":"Project","text":""},{"location":"models/project/#docforge.models.project","title":"docforge.models.project","text":"<p>Documentation model representing a project.</p> <p>This module defines the <code>Project</code> class, the top-level container used by doc-forge to represent a documented codebase. A <code>Project</code> aggregates multiple modules and provides access to them through a unified interface.</p>"},{"location":"models/project/#docforge.models.project-classes","title":"Classes","text":""},{"location":"models/project/#docforge.models.project.Project","title":"Project","text":"<pre><code>Project(name: str)\n</code></pre> <p>Representation of a documentation project.</p> <p>A <code>Project</code> serves as the root container for all modules discovered during introspection. Each module is stored by its dotted import path.</p> <p>Attributes:</p> Name Type Description <code>name</code> <code>str</code> <p>Name of the project.</p> <code>modules</code> <code>Dict[str, Module]</code> <p>Mapping of module paths to <code>Module</code> instances.</p> <p>Initialize a Project instance.</p> <p>Parameters:</p> Name Type Description Default <code>name</code> <code>str</code> <p>Name used to identify the documentation project.</p> required"},{"location":"models/project/#docforge.models.project.Project-functions","title":"Functions","text":""},{"location":"models/project/#docforge.models.project.Project.add_module","title":"add_module","text":"<pre><code>add_module(module: Module) -&gt; None\n</code></pre> <p>Register a module in the project.</p> <p>Parameters:</p> Name Type Description Default <code>module</code> <code>Module</code> <p>Module instance to add to the project.</p> required"},{"location":"models/project/#docforge.models.project.Project.get_all_modules","title":"get_all_modules","text":"<pre><code>get_all_modules() -&gt; Iterable[Module]\n</code></pre> <p>Return all modules contained in the project.</p> <p>Returns:</p> Type Description <code>Iterable[Module]</code> <p>An iterable of <code>Module</code> instances.</p>"},{"location":"models/project/#docforge.models.project.Project.get_module","title":"get_module","text":"<pre><code>get_module(path: str) -&gt; Module\n</code></pre> <p>Retrieve a module by its dotted path.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>str</code> <p>Fully qualified dotted module path (for example <code>pkg.module</code>).</p> required <p>Returns:</p> Type Description <code>Module</code> <p>The corresponding <code>Module</code> instance.</p> <p>Raises:</p> Type Description <code>KeyError</code> <p>If the module does not exist in the project.</p>"},{"location":"models/project/#docforge.models.project.Project.get_module_list","title":"get_module_list","text":"<pre><code>get_module_list() -&gt; list[str]\n</code></pre> <p>Return the list of module import paths.</p> <p>Returns:</p> Type Description <code>list[str]</code> <p>A list containing the dotted paths of all modules in the project.</p>"},{"location":"nav/","title":"Nav","text":""},{"location":"nav/#docforge.nav","title":"docforge.nav","text":"<p>Navigation layer for doc-forge.</p> <p>The <code>docforge.nav</code> package manages the relationship between the logical documentation structure defined by the user and the physical documentation files generated on disk.</p>"},{"location":"nav/#docforge.nav--workflow","title":"Workflow","text":"<ol> <li>Specification \u2013 Users define navigation intent in <code>docforge.nav.yml</code>.</li> <li>Resolution \u2013 <code>resolve_nav</code> expands patterns and matches them against    generated Markdown files.</li> <li>Emission \u2013 <code>MkDocsNavEmitter</code> converts the resolved structure into    the YAML navigation format required by <code>mkdocs.yml</code>.</li> </ol> <p>This layer separates documentation organization from the underlying source code layout, enabling flexible grouping, ordering, and navigation structures independent of module hierarchy.</p>"},{"location":"nav/#docforge.nav-classes","title":"Classes","text":""},{"location":"nav/#docforge.nav.MkDocsNavEmitter","title":"MkDocsNavEmitter","text":"<p>Emit MkDocs navigation structures from resolved navigation data.</p> <p>The emitter transforms a <code>ResolvedNav</code> object into the YAML-compatible list structure expected by the MkDocs <code>nav</code> configuration field.</p>"},{"location":"nav/#docforge.nav.MkDocsNavEmitter-functions","title":"Functions","text":""},{"location":"nav/#docforge.nav.MkDocsNavEmitter.emit","title":"emit","text":"<pre><code>emit(nav: ResolvedNav) -&gt; List[Dict[str, Any]]\n</code></pre> <p>Generate a navigation structure for <code>mkdocs.yml</code>.</p> <p>Parameters:</p> Name Type Description Default <code>nav</code> <code>ResolvedNav</code> <p>Resolved navigation data describing documentation groups and their associated Markdown files.</p> required <p>Returns:</p> Type Description <code>List[Dict[str, Any]]</code> <p>A list of dictionaries representing the MkDocs navigation layout.</p> <code>List[Dict[str, Any]]</code> <p>Each dictionary maps a navigation label to a page or a list of</p> <code>List[Dict[str, Any]]</code> <p>pages.</p>"},{"location":"nav/#docforge.nav.NavSpec","title":"NavSpec","text":"<pre><code>NavSpec(home: Optional[str], groups: Dict[str, List[str]])\n</code></pre> <p>Parsed representation of a navigation specification.</p> <p>A <code>NavSpec</code> describes the intended documentation navigation layout before it is resolved against the filesystem.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Relative path to the documentation home page (for example <code>index.md</code>).</p> <code>groups</code> <code>Dict[str, List[str]]</code> <p>Mapping of navigation group titles to lists of file patterns or glob expressions.</p> <p>Initialize a NavSpec instance.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>Optional[str]</code> <p>Relative path to the home document.</p> required <code>groups</code> <code>Dict[str, List[str]]</code> <p>Mapping of group names to lists of path patterns (glob expressions).</p> required"},{"location":"nav/#docforge.nav.NavSpec-functions","title":"Functions","text":""},{"location":"nav/#docforge.nav.NavSpec.all_patterns","title":"all_patterns","text":"<pre><code>all_patterns() -&gt; List[str]\n</code></pre> <p>Return all path patterns referenced by the specification.</p> <p>Returns:</p> Type Description <code>List[str]</code> <p>A list containing the home document (if defined) and all</p> <code>List[str]</code> <p>group pattern entries.</p>"},{"location":"nav/#docforge.nav.NavSpec.load","title":"load  <code>classmethod</code>","text":"<pre><code>load(path: Path) -&gt; NavSpec\n</code></pre> <p>Load a navigation specification from a YAML file.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>Filesystem path to the navigation specification file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A <code>NavSpec</code> instance representing the parsed configuration.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specified file does not exist.</p> <code>ValueError</code> <p>If the file contents are not a valid navigation specification.</p>"},{"location":"nav/#docforge.nav.ResolvedNav","title":"ResolvedNav","text":"<pre><code>ResolvedNav(home: str | None, groups: Dict[str, List[Path]], docs_root: Path | None = None)\n</code></pre> <p>Resolved navigation structure.</p> <p>A <code>ResolvedNav</code> represents navigation data after glob patterns have been expanded and paths validated against the filesystem.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Relative path to the documentation home page.</p> <code>groups</code> <code>Dict[str, List[Path]]</code> <p>Mapping of navigation group titles to lists of resolved documentation file paths.</p> <p>Initialize a ResolvedNav instance.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>str | None</code> <p>Relative path to the home page within the documentation root.</p> required <code>groups</code> <code>Dict[str, List[Path]]</code> <p>Mapping of group titles to resolved documentation file paths.</p> required <code>docs_root</code> <code>Path | None</code> <p>Root directory of the documentation source files.</p> <code>None</code>"},{"location":"nav/#docforge.nav.ResolvedNav-functions","title":"Functions","text":""},{"location":"nav/#docforge.nav.ResolvedNav.all_files","title":"all_files","text":"<pre><code>all_files() -&gt; Iterable[Path]\n</code></pre> <p>Iterate over all files referenced by the navigation structure.</p> <p>Returns:</p> Type Description <code>Iterable[Path]</code> <p>An iterable of <code>Path</code> objects representing documentation files.</p> <p>Raises:</p> Type Description <code>RuntimeError</code> <p>If the home page is defined but the documentation root is not available for resolution.</p>"},{"location":"nav/#docforge.nav-functions","title":"Functions","text":""},{"location":"nav/#docforge.nav.load_nav_spec","title":"load_nav_spec","text":"<pre><code>load_nav_spec(path: Path) -&gt; NavSpec\n</code></pre> <p>Load a navigation specification file.</p> <p>This helper function reads a YAML navigation file and constructs a corresponding <code>NavSpec</code> instance.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>Path to the navigation specification file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A <code>NavSpec</code> instance representing the parsed specification.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specification file does not exist.</p> <code>ValueError</code> <p>If the YAML structure is invalid.</p>"},{"location":"nav/#docforge.nav.resolve_nav","title":"resolve_nav","text":"<pre><code>resolve_nav(spec: NavSpec, docs_root: Path) -&gt; ResolvedNav\n</code></pre> <p>Resolve a navigation specification against the filesystem.</p> <p>The function expands glob patterns defined in a <code>NavSpec</code> and verifies that referenced documentation files exist within the documentation root.</p> <p>Parameters:</p> Name Type Description Default <code>spec</code> <code>NavSpec</code> <p>Navigation specification describing documentation layout.</p> required <code>docs_root</code> <code>Path</code> <p>Root directory containing documentation Markdown files.</p> required <p>Returns:</p> Type Description <code>ResolvedNav</code> <p>A <code>ResolvedNav</code> instance containing validated navigation paths.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the documentation root does not exist or a navigation pattern does not match any files.</p>"},{"location":"nav/mkdocs/","title":"Mkdocs","text":""},{"location":"nav/mkdocs/#docforge.nav.mkdocs","title":"docforge.nav.mkdocs","text":"<p>MkDocs navigation emitter.</p> <p>This module provides the <code>MkDocsNavEmitter</code> class, which converts a <code>ResolvedNav</code> instance into the navigation structure required by the MkDocs <code>nav</code> configuration.</p>"},{"location":"nav/mkdocs/#docforge.nav.mkdocs-classes","title":"Classes","text":""},{"location":"nav/mkdocs/#docforge.nav.mkdocs.MkDocsNavEmitter","title":"MkDocsNavEmitter","text":"<p>Emit MkDocs navigation structures from resolved navigation data.</p> <p>The emitter transforms a <code>ResolvedNav</code> object into the YAML-compatible list structure expected by the MkDocs <code>nav</code> configuration field.</p>"},{"location":"nav/mkdocs/#docforge.nav.mkdocs.MkDocsNavEmitter-functions","title":"Functions","text":""},{"location":"nav/mkdocs/#docforge.nav.mkdocs.MkDocsNavEmitter.emit","title":"emit","text":"<pre><code>emit(nav: ResolvedNav) -&gt; List[Dict[str, Any]]\n</code></pre> <p>Generate a navigation structure for <code>mkdocs.yml</code>.</p> <p>Parameters:</p> Name Type Description Default <code>nav</code> <code>ResolvedNav</code> <p>Resolved navigation data describing documentation groups and their associated Markdown files.</p> required <p>Returns:</p> Type Description <code>List[Dict[str, Any]]</code> <p>A list of dictionaries representing the MkDocs navigation layout.</p> <code>List[Dict[str, Any]]</code> <p>Each dictionary maps a navigation label to a page or a list of</p> <code>List[Dict[str, Any]]</code> <p>pages.</p>"},{"location":"nav/resolver/","title":"Resolver","text":""},{"location":"nav/resolver/#docforge.nav.resolver","title":"docforge.nav.resolver","text":"<p>Navigation resolution utilities.</p> <p>This module resolves a <code>NavSpec</code> against the filesystem by expanding glob patterns and validating that referenced documentation files exist.</p>"},{"location":"nav/resolver/#docforge.nav.resolver-classes","title":"Classes","text":""},{"location":"nav/resolver/#docforge.nav.resolver.ResolvedNav","title":"ResolvedNav","text":"<pre><code>ResolvedNav(home: str | None, groups: Dict[str, List[Path]], docs_root: Path | None = None)\n</code></pre> <p>Resolved navigation structure.</p> <p>A <code>ResolvedNav</code> represents navigation data after glob patterns have been expanded and paths validated against the filesystem.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Relative path to the documentation home page.</p> <code>groups</code> <code>Dict[str, List[Path]]</code> <p>Mapping of navigation group titles to lists of resolved documentation file paths.</p> <p>Initialize a ResolvedNav instance.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>str | None</code> <p>Relative path to the home page within the documentation root.</p> required <code>groups</code> <code>Dict[str, List[Path]]</code> <p>Mapping of group titles to resolved documentation file paths.</p> required <code>docs_root</code> <code>Path | None</code> <p>Root directory of the documentation source files.</p> <code>None</code>"},{"location":"nav/resolver/#docforge.nav.resolver.ResolvedNav-functions","title":"Functions","text":""},{"location":"nav/resolver/#docforge.nav.resolver.ResolvedNav.all_files","title":"all_files","text":"<pre><code>all_files() -&gt; Iterable[Path]\n</code></pre> <p>Iterate over all files referenced by the navigation structure.</p> <p>Returns:</p> Type Description <code>Iterable[Path]</code> <p>An iterable of <code>Path</code> objects representing documentation files.</p> <p>Raises:</p> Type Description <code>RuntimeError</code> <p>If the home page is defined but the documentation root is not available for resolution.</p>"},{"location":"nav/resolver/#docforge.nav.resolver-functions","title":"Functions","text":""},{"location":"nav/resolver/#docforge.nav.resolver.resolve_nav","title":"resolve_nav","text":"<pre><code>resolve_nav(spec: NavSpec, docs_root: Path) -&gt; ResolvedNav\n</code></pre> <p>Resolve a navigation specification against the filesystem.</p> <p>The function expands glob patterns defined in a <code>NavSpec</code> and verifies that referenced documentation files exist within the documentation root.</p> <p>Parameters:</p> Name Type Description Default <code>spec</code> <code>NavSpec</code> <p>Navigation specification describing documentation layout.</p> required <code>docs_root</code> <code>Path</code> <p>Root directory containing documentation Markdown files.</p> required <p>Returns:</p> Type Description <code>ResolvedNav</code> <p>A <code>ResolvedNav</code> instance containing validated navigation paths.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the documentation root does not exist or a navigation pattern does not match any files.</p>"},{"location":"nav/spec/","title":"Spec","text":""},{"location":"nav/spec/#docforge.nav.spec","title":"docforge.nav.spec","text":"<p>Navigation specification model.</p> <p>This module defines the <code>NavSpec</code> class, which represents the navigation structure defined by the user in the doc-forge navigation specification (typically <code>docforge.nav.yml</code>).</p>"},{"location":"nav/spec/#docforge.nav.spec-classes","title":"Classes","text":""},{"location":"nav/spec/#docforge.nav.spec.NavSpec","title":"NavSpec","text":"<pre><code>NavSpec(home: Optional[str], groups: Dict[str, List[str]])\n</code></pre> <p>Parsed representation of a navigation specification.</p> <p>A <code>NavSpec</code> describes the intended documentation navigation layout before it is resolved against the filesystem.</p> <p>Attributes:</p> Name Type Description <code>home</code> <code>Optional[str]</code> <p>Relative path to the documentation home page (for example <code>index.md</code>).</p> <code>groups</code> <code>Dict[str, List[str]]</code> <p>Mapping of navigation group titles to lists of file patterns or glob expressions.</p> <p>Initialize a NavSpec instance.</p> <p>Parameters:</p> Name Type Description Default <code>home</code> <code>Optional[str]</code> <p>Relative path to the home document.</p> required <code>groups</code> <code>Dict[str, List[str]]</code> <p>Mapping of group names to lists of path patterns (glob expressions).</p> required"},{"location":"nav/spec/#docforge.nav.spec.NavSpec-functions","title":"Functions","text":""},{"location":"nav/spec/#docforge.nav.spec.NavSpec.all_patterns","title":"all_patterns","text":"<pre><code>all_patterns() -&gt; List[str]\n</code></pre> <p>Return all path patterns referenced by the specification.</p> <p>Returns:</p> Type Description <code>List[str]</code> <p>A list containing the home document (if defined) and all</p> <code>List[str]</code> <p>group pattern entries.</p>"},{"location":"nav/spec/#docforge.nav.spec.NavSpec.load","title":"load  <code>classmethod</code>","text":"<pre><code>load(path: Path) -&gt; NavSpec\n</code></pre> <p>Load a navigation specification from a YAML file.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>Filesystem path to the navigation specification file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A <code>NavSpec</code> instance representing the parsed configuration.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specified file does not exist.</p> <code>ValueError</code> <p>If the file contents are not a valid navigation specification.</p>"},{"location":"nav/spec/#docforge.nav.spec-functions","title":"Functions","text":""},{"location":"nav/spec/#docforge.nav.spec.load_nav_spec","title":"load_nav_spec","text":"<pre><code>load_nav_spec(path: Path) -&gt; NavSpec\n</code></pre> <p>Load a navigation specification file.</p> <p>This helper function reads a YAML navigation file and constructs a corresponding <code>NavSpec</code> instance.</p> <p>Parameters:</p> Name Type Description Default <code>path</code> <code>Path</code> <p>Path to the navigation specification file.</p> required <p>Returns:</p> Type Description <code>NavSpec</code> <p>A <code>NavSpec</code> instance representing the parsed specification.</p> <p>Raises:</p> Type Description <code>FileNotFoundError</code> <p>If the specification file does not exist.</p> <code>ValueError</code> <p>If the YAML structure is invalid.</p>"},{"location":"renderers/","title":"Renderers","text":""},{"location":"renderers/#docforge.renderers","title":"docforge.renderers","text":"<p>Renderers layer for doc-forge.</p> <p>The <code>docforge.renderers</code> package transforms the internal documentation models into files formatted for specific documentation systems.</p>"},{"location":"renderers/#docforge.renderers--overview","title":"Overview","text":"<p>Renderers consume the doc-forge project model and generate output suitable for documentation tools or machine interfaces.</p> <p>Current implementations:</p> <ul> <li>MkDocsRenderer \u2013 Produces Markdown files compatible with MkDocs and   the <code>mkdocstrings</code> plugin. It automatically handles package hierarchy   and generates <code>index.md</code> files for packages.</li> <li>MCPRenderer \u2013 Emits structured JSON resources designed for consumption   by Model Context Protocol (MCP) clients.</li> </ul>"},{"location":"renderers/#docforge.renderers--extending","title":"Extending","text":"<p>New renderers can be added by implementing the <code>DocRenderer</code> protocol defined in <code>docforge.renderers.base</code>.</p>"},{"location":"renderers/#docforge.renderers-classes","title":"Classes","text":""},{"location":"renderers/#docforge.renderers.MCPRenderer","title":"MCPRenderer","text":"<p>Renderer that generates MCP-compatible documentation resources.</p> <p>This renderer converts doc-forge project models into structured JSON resources suitable for consumption by systems implementing the Model Context Protocol (MCP).</p>"},{"location":"renderers/#docforge.renderers.MCPRenderer-functions","title":"Functions","text":""},{"location":"renderers/#docforge.renderers.MCPRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP documentation resources for a project.</p> <p>The renderer serializes each module into a JSON resource and produces supporting metadata files such as <code>nav.json</code> and <code>index.json</code>.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Documentation project model to render.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where MCP resources will be written.</p> required"},{"location":"renderers/#docforge.renderers.MkDocsRenderer","title":"MkDocsRenderer","text":"<p>Renderer that produces Markdown documentation for MkDocs.</p> <p>Generated pages use mkdocstrings directives to reference Python modules, allowing MkDocs to render API documentation dynamically.</p>"},{"location":"renderers/#docforge.renderers.MkDocsRenderer-functions","title":"Functions","text":""},{"location":"renderers/#docforge.renderers.MkDocsRenderer.generate_readme","title":"generate_readme","text":"<pre><code>generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate a <code>README.md</code> file from the root module docstring.</p> <p>Behavior:</p> <ul> <li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the   project root directory.</li> <li>If False, README generation is currently not implemented.</li> </ul> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing documentation metadata.</p> required <code>docs_dir</code> <code>Path</code> <p>Directory containing generated documentation sources.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Whether the module is treated as the project source root.</p> <code>None</code>"},{"location":"renderers/#docforge.renderers.MkDocsRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate Markdown documentation files for a project.</p> <p>This method renders a documentation structure from the provided project model and writes the resulting Markdown files to the specified output directory.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing modules to document.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where generated Markdown files will be written.</p> required <code>module_is_source</code> <code>bool | None</code> <p>If True, treat the specified module as the documentation root rather than nesting it inside a folder.</p> <code>None</code>"},{"location":"renderers/base/","title":"Base","text":""},{"location":"renderers/base/#docforge.renderers.base","title":"docforge.renderers.base","text":"<p>Renderer base interfaces and configuration models.</p> <p>This module defines the base protocol and configuration container used by doc-forge renderers. Concrete renderer implementations should implement the <code>DocRenderer</code> protocol.</p>"},{"location":"renderers/base/#docforge.renderers.base-classes","title":"Classes","text":""},{"location":"renderers/base/#docforge.renderers.base.DocRenderer","title":"DocRenderer","text":"<p>               Bases: <code>Protocol</code></p> <p>Protocol defining the interface for documentation renderers.</p> <p>Implementations of this protocol are responsible for transforming a <code>Project</code> model into renderer-specific documentation sources.</p>"},{"location":"renderers/base/#docforge.renderers.base.DocRenderer-functions","title":"Functions","text":""},{"location":"renderers/base/#docforge.renderers.base.DocRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate renderer-specific documentation sources.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing modules and documentation objects.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where generated documentation sources should be written.</p> required"},{"location":"renderers/base/#docforge.renderers.base.RendererConfig","title":"RendererConfig","text":"<pre><code>RendererConfig(out_dir: Path, project: Project)\n</code></pre> <p>Configuration container for documentation renderers.</p> <p>A <code>RendererConfig</code> instance groups together the project model and the output directory used during rendering.</p> <p>Attributes:</p> Name Type Description <code>out_dir</code> <code>Path</code> <p>Directory where generated documentation files will be written.</p> <code>project</code> <code>Project</code> <p>Documentation project model to be rendered.</p> <p>Initialize a RendererConfig instance.</p> <p>Parameters:</p> Name Type Description Default <code>out_dir</code> <code>Path</code> <p>Target directory where documentation files should be written.</p> required <code>project</code> <code>Project</code> <p>Introspected project model to render.</p> required"},{"location":"renderers/base/#docforge.renderers.base.RendererConfig-functions","title":"Functions","text":""},{"location":"renderers/mcp_renderer/","title":"Mcp Renderer","text":""},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer","title":"docforge.renderers.mcp_renderer","text":""},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer-classes","title":"Classes","text":""},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer.MCPRenderer","title":"MCPRenderer","text":"<p>Renderer that generates MCP-compatible documentation resources.</p> <p>This renderer converts doc-forge project models into structured JSON resources suitable for consumption by systems implementing the Model Context Protocol (MCP).</p>"},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer.MCPRenderer-functions","title":"Functions","text":""},{"location":"renderers/mcp_renderer/#docforge.renderers.mcp_renderer.MCPRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path) -&gt; None\n</code></pre> <p>Generate MCP documentation resources for a project.</p> <p>The renderer serializes each module into a JSON resource and produces supporting metadata files such as <code>nav.json</code> and <code>index.json</code>.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Documentation project model to render.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where MCP resources will be written.</p> required"},{"location":"renderers/mkdocs_renderer/","title":"Mkdocs Renderer","text":""},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer","title":"docforge.renderers.mkdocs_renderer","text":"<p>MkDocs renderer implementation.</p> <p>This module defines the <code>MkDocsRenderer</code> class, which generates Markdown documentation sources compatible with MkDocs Material and the mkdocstrings plugin.</p> <p>The renderer ensures a consistent documentation structure by:</p> <ul> <li>Creating a root <code>index.md</code> if one does not exist</li> <li>Generating package index pages automatically</li> <li>Linking child modules within parent package pages</li> <li>Optionally generating <code>README.md</code> from the root package docstring</li> </ul>"},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer-classes","title":"Classes","text":""},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer.MkDocsRenderer","title":"MkDocsRenderer","text":"<p>Renderer that produces Markdown documentation for MkDocs.</p> <p>Generated pages use mkdocstrings directives to reference Python modules, allowing MkDocs to render API documentation dynamically.</p>"},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer.MkDocsRenderer-functions","title":"Functions","text":""},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_readme","title":"generate_readme","text":"<pre><code>generate_readme(project: Project, docs_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate a <code>README.md</code> file from the root module docstring.</p> <p>Behavior:</p> <ul> <li>If <code>module_is_source</code> is True, <code>README.md</code> is written to the   project root directory.</li> <li>If False, README generation is currently not implemented.</li> </ul> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing documentation metadata.</p> required <code>docs_dir</code> <code>Path</code> <p>Directory containing generated documentation sources.</p> required <code>module_is_source</code> <code>bool | None</code> <p>Whether the module is treated as the project source root.</p> <code>None</code>"},{"location":"renderers/mkdocs_renderer/#docforge.renderers.mkdocs_renderer.MkDocsRenderer.generate_sources","title":"generate_sources","text":"<pre><code>generate_sources(project: Project, out_dir: Path, module_is_source: bool | None = None) -&gt; None\n</code></pre> <p>Generate Markdown documentation files for a project.</p> <p>This method renders a documentation structure from the provided project model and writes the resulting Markdown files to the specified output directory.</p> <p>Parameters:</p> Name Type Description Default <code>project</code> <code>Project</code> <p>Project model containing modules to document.</p> required <code>out_dir</code> <code>Path</code> <p>Directory where generated Markdown files will be written.</p> required <code>module_is_source</code> <code>bool | None</code> <p>If True, treat the specified module as the documentation root rather than nesting it inside a folder.</p> <code>None</code>"},{"location":"servers/","title":"Servers","text":""},{"location":"servers/#docforge.servers","title":"docforge.servers","text":"<p>Server layer for doc-forge.</p> <p>This module exposes server implementations used to provide live access to generated documentation resources. Currently, it includes the MCP documentation server.</p>"},{"location":"servers/#docforge.servers-classes","title":"Classes","text":""},{"location":"servers/#docforge.servers.MCPServer","title":"MCPServer","text":"<pre><code>MCPServer(mcp_root: Path, name: str)\n</code></pre> <p>MCP server for serving a pre-generated documentation bundle.</p> <p>The server exposes documentation resources and diagnostic tools through MCP endpoints backed by JSON files generated by the MCP renderer.</p> <p>Initialize the MCP server.</p> <p>Parameters:</p> Name Type Description Default <code>mcp_root</code> <code>Path</code> <p>Directory containing the generated MCP documentation bundle (for example <code>index.json</code>, <code>nav.json</code>, and <code>modules/</code>).</p> required <code>name</code> <code>str</code> <p>Identifier used for the MCP server instance.</p> required"},{"location":"servers/#docforge.servers.MCPServer-functions","title":"Functions","text":""},{"location":"servers/#docforge.servers.MCPServer.run","title":"run","text":"<pre><code>run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http') -&gt; None\n</code></pre> <p>Start the MCP server.</p> <p>Parameters:</p> Name Type Description Default <code>transport</code> <code>Literal['stdio', 'sse', 'streamable-http']</code> <p>Transport mechanism used by the MCP server. Supported options include <code>stdio</code>, <code>sse</code>, and <code>streamable-http</code>.</p> <code>'streamable-http'</code>"},{"location":"servers/mcp_server/","title":"Mcp Server","text":""},{"location":"servers/mcp_server/#docforge.servers.mcp_server","title":"docforge.servers.mcp_server","text":""},{"location":"servers/mcp_server/#docforge.servers.mcp_server-classes","title":"Classes","text":""},{"location":"servers/mcp_server/#docforge.servers.mcp_server.MCPServer","title":"MCPServer","text":"<pre><code>MCPServer(mcp_root: Path, name: str)\n</code></pre> <p>MCP server for serving a pre-generated documentation bundle.</p> <p>The server exposes documentation resources and diagnostic tools through MCP endpoints backed by JSON files generated by the MCP renderer.</p> <p>Initialize the MCP server.</p> <p>Parameters:</p> Name Type Description Default <code>mcp_root</code> <code>Path</code> <p>Directory containing the generated MCP documentation bundle (for example <code>index.json</code>, <code>nav.json</code>, and <code>modules/</code>).</p> required <code>name</code> <code>str</code> <p>Identifier used for the MCP server instance.</p> required"},{"location":"servers/mcp_server/#docforge.servers.mcp_server.MCPServer-functions","title":"Functions","text":""},{"location":"servers/mcp_server/#docforge.servers.mcp_server.MCPServer.run","title":"run","text":"<pre><code>run(transport: Literal['stdio', 'sse', 'streamable-http'] = 'streamable-http') -&gt; None\n</code></pre> <p>Start the MCP server.</p> <p>Parameters:</p> Name Type Description Default <code>transport</code> <code>Literal['stdio', 'sse', 'streamable-http']</code> <p>Transport mechanism used by the MCP server. Supported options include <code>stdio</code>, <code>sse</code>, and <code>streamable-http</code>.</p> <code>'streamable-http'</code>"}]}
\ No newline at end of file
diff --git a/libs/doc-forge/site/servers/index.html b/libs/doc-forge/site/servers/index.html
index a853e30..2fe1168 100644
--- a/libs/doc-forge/site/servers/index.html
+++ b/libs/doc-forge/site/servers/index.html
@@ -82,7 +82,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href=".." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -147,12 +149,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -178,134 +187,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href=".." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -319,10 +200,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href=".." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -365,13 +244,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -380,8 +269,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -390,8 +280,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -401,27 +297,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -461,13 +336,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -476,8 +365,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -486,8 +376,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -497,27 +393,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -603,13 +478,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -618,8 +507,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -628,8 +518,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -639,27 +535,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -745,13 +620,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -760,8 +649,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -770,8 +660,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -781,27 +677,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -887,13 +762,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -902,8 +793,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -912,8 +804,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -923,27 +821,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1081,6 +958,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.servers-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.servers.MCPServer" class="md-nav__link">
     <span class="md-ellipsis">
       MCPServer
@@ -1091,6 +978,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.servers.MCPServer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.servers.MCPServer.run" class="md-nav__link">
     <span class="md-ellipsis">
       run
@@ -1107,6 +1004,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1133,13 +1040,19 @@
 
 
 <h2 id="docforge.servers" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.servers</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.servers</span>
 
 
 </h2>
 
     <div class="doc doc-contents first">
 
+      <p>Server layer for doc-forge.</p>
+<p>This module exposes server implementations used to provide live access
+to generated documentation resources. Currently, it includes the MCP
+documentation server.</p>
+<hr />
+
 
 
   <div class="doc doc-children">
@@ -1149,26 +1062,28 @@
 
 
 
-
+<h3 id="docforge.servers-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.servers.MCPServer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MCPServer</span>
+<h4 id="docforge.servers.MCPServer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MCPServer</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">MCPServer</span><span class="p">(</span><span class="n">mcp_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">MCPServer</span><span class="p">(</span><span class="n">mcp_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>MCP server for serving a pre-built MCP documentation bundle.</p>
+      <p>MCP server for serving a pre-generated documentation bundle.</p>
+<p>The server exposes documentation resources and diagnostic tools through
+MCP endpoints backed by JSON files generated by the MCP renderer.</p>
 
-      <p>Initialize the MCPServer.</p>
+      <p>Initialize the MCP server.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1189,7 +1104,9 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the directory containing pre-built MCP JSON resources.</p>
+                <p>Directory containing the generated MCP documentation
+bundle (for example <code>index.json</code>, <code>nav.json</code>, and
+<code>modules/</code>).</p>
               </div>
             </td>
             <td>
@@ -1203,7 +1120,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Name of the MCP server.</p>
+                <p>Identifier used for the MCP server instance.</p>
               </div>
             </td>
             <td>
@@ -1224,18 +1141,18 @@
 
 
 
-
+<h5 id="docforge.servers.MCPServer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.servers.MCPServer.run" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">run</span>
+<h6 id="docforge.servers.MCPServer.run" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">run</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">run</span><span class="p">(</span><span class="n">transport</span><span class="p">:</span> <span class="n">Literal</span><span class="p">[</span><span class="s1">&#39;stdio&#39;</span><span class="p">,</span> <span class="s1">&#39;sse&#39;</span><span class="p">,</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">run</span><span class="p">(</span><span class="n">transport</span><span class="p">:</span> <span class="n">Literal</span><span class="p">[</span><span class="s1">&#39;stdio&#39;</span><span class="p">,</span> <span class="s1">&#39;sse&#39;</span><span class="p">,</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
@@ -1260,7 +1177,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>MCP transport (default: streamable-http)</p>
+                <p>Transport mechanism used by the MCP server. Supported
+options include <code>stdio</code>, <code>sse</code>, and <code>streamable-http</code>.</p>
               </div>
             </td>
             <td>
@@ -1307,6 +1225,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1344,7 +1264,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/servers/mcp_server/index.html b/libs/doc-forge/site/servers/mcp_server/index.html
index 70d646a..fd997a3 100644
--- a/libs/doc-forge/site/servers/mcp_server/index.html
+++ b/libs/doc-forge/site/servers/mcp_server/index.html
@@ -82,7 +82,9 @@
     
       
 
-<header class="md-header" data-md-component="header">
+  
+
+<header class="md-header md-header--shadow" data-md-component="header">
   <nav class="md-header__inner md-grid" aria-label="Header">
     <a href="../.." title="docforge" class="md-header__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -147,12 +149,19 @@
       </label>
       <nav class="md-search__options" aria-label="Search">
         
+          <a href="javascript:void(0)" class="md-search__icon md-icon" title="Share" aria-label="Share" data-clipboard data-clipboard-text="" data-md-component="search-share" tabindex="-1">
+            
+            <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M18 16.08c-.76 0-1.44.3-1.96.77L8.91 12.7c.05-.23.09-.46.09-.7s-.04-.47-.09-.7l7.05-4.11c.54.5 1.25.81 2.04.81a3 3 0 0 0 3-3 3 3 0 0 0-3-3 3 3 0 0 0-3 3c0 .24.04.47.09.7L8.04 9.81C7.5 9.31 6.79 9 6 9a3 3 0 0 0-3 3 3 3 0 0 0 3 3c.79 0 1.5-.31 2.04-.81l7.12 4.15c-.05.21-.08.43-.08.66 0 1.61 1.31 2.91 2.92 2.91s2.92-1.3 2.92-2.91A2.92 2.92 0 0 0 18 16.08"/></svg>
+          </a>
+        
         <button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">
           
           <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>
         </button>
       </nav>
       
+        <div class="md-search__suggest" data-md-component="search-suggest"></div>
+      
     </form>
     <div class="md-search__output">
       <div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>
@@ -178,134 +187,6 @@
       
         
           
-            
-<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">
-  <div class="md-grid">
-    <ul class="md-tabs__list">
-      
-        
-  
-  
-  
-  
-    <li class="md-tabs__item">
-      <a href="../.." class="md-tabs__link">
-        
-  
-  
-    
-  
-  Home
-
-      </a>
-    </li>
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../loaders/" class="md-tabs__link">
-          
-  
-  
-  Loaders
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../models/" class="md-tabs__link">
-          
-  
-  
-  Models
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../nav/" class="md-tabs__link">
-          
-  
-  
-  Navigation
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../renderers/" class="md-tabs__link">
-          
-  
-  
-  Renderers
-
-        </a>
-      </li>
-    
-  
-
-      
-        
-  
-  
-  
-  
-    
-    
-      <li class="md-tabs__item">
-        <a href="../../cli/" class="md-tabs__link">
-          
-  
-  
-  CLI
-
-        </a>
-      </li>
-    
-  
-
-      
-    </ul>
-  </div>
-</nav>
-          
         
       
       <main class="md-main" data-md-component="main">
@@ -319,10 +200,8 @@
                     
 
 
-  
 
-
-<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">
+<nav class="md-nav md-nav--primary" aria-label="Navigation" data-md-level="0">
   <label class="md-nav__title" for="__drawer">
     <a href="../.." title="docforge" class="md-nav__button md-logo" aria-label="docforge" data-md-component="logo">
       
@@ -365,13 +244,23 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -380,8 +269,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >
         
           
-          <label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../loaders/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -390,8 +280,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_2" id="__nav_2_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_2">
@@ -401,27 +297,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../loaders/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Loaders
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -461,13 +336,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -476,8 +365,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >
         
           
-          <label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../models/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -486,8 +376,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_3" id="__nav_3_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_3">
@@ -497,27 +393,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../models/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Models
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -603,13 +478,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -618,8 +507,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >
         
           
-          <label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../nav/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -628,8 +518,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_4" id="__nav_4_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_4">
@@ -639,27 +535,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../nav/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Nav
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -745,13 +620,27 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -760,8 +649,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >
         
           
-          <label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../renderers/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -770,8 +660,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_5" id="__nav_5_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_5">
@@ -781,27 +677,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../renderers/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Renderers
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -887,13 +762,29 @@
   
     
     
-    
-    
       
+        
+          
+        
+      
+        
+      
+        
+      
+        
+      
+        
       
     
     
-    <li class="md-nav__item md-nav__item--nested">
+    
+      
+        
+        
+      
+    
+    
+    <li class="md-nav__item md-nav__item--section md-nav__item--nested">
       
         
         
@@ -902,8 +793,9 @@
         <input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_6" >
         
           
-          <label class="md-nav__link" for="__nav_6" id="__nav_6_label" tabindex="0">
-            
+          <div class="md-nav__link md-nav__container">
+            <a href="../../cli/" class="md-nav__link ">
+              
   
   
   <span class="md-ellipsis">
@@ -912,8 +804,14 @@
   </span>
   
 
-            <span class="md-nav__icon md-icon"></span>
-          </label>
+            </a>
+            
+              
+              <label class="md-nav__link " for="__nav_6" id="__nav_6_label" tabindex="">
+                <span class="md-nav__icon md-icon"></span>
+              </label>
+            
+          </div>
         
         <nav class="md-nav" data-md-level="1" aria-labelledby="__nav_6_label" aria-expanded="false">
           <label class="md-nav__title" for="__nav_6">
@@ -923,27 +821,6 @@
           <ul class="md-nav__list" data-md-scrollfix>
             
               
-                
-  
-  
-  
-  
-    <li class="md-nav__item">
-      <a href="../../cli/" class="md-nav__link">
-        
-  
-  
-  <span class="md-ellipsis">
-    Cli
-    
-  </span>
-  
-
-      </a>
-    </li>
-  
-
-              
             
               
                 
@@ -1081,6 +958,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.servers.mcp_server-classes" class="md-nav__link">
+    <span class="md-ellipsis">
+      Classes
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Classes">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.servers.mcp_server.MCPServer" class="md-nav__link">
     <span class="md-ellipsis">
       MCPServer
@@ -1091,6 +978,16 @@
       <ul class="md-nav__list">
         
           <li class="md-nav__item">
+  <a href="#docforge.servers.mcp_server.MCPServer-functions" class="md-nav__link">
+    <span class="md-ellipsis">
+      Functions
+    </span>
+  </a>
+  
+    <nav class="md-nav" aria-label="Functions">
+      <ul class="md-nav__list">
+        
+          <li class="md-nav__item">
   <a href="#docforge.servers.mcp_server.MCPServer.run" class="md-nav__link">
     <span class="md-ellipsis">
       run
@@ -1107,6 +1004,16 @@
       </ul>
     </nav>
   
+</li>
+        
+      </ul>
+    </nav>
+  
+</li>
+        
+      </ul>
+    </nav>
+  
 </li>
       
     </ul>
@@ -1133,7 +1040,7 @@
 
 
 <h2 id="docforge.servers.mcp_server" class="doc doc-heading">
-            <span class="doc doc-object-name doc-module-name">docforge.servers.mcp_server</span>
+<code class="doc-symbol doc-symbol-heading doc-symbol-module"></code>            <span class="doc doc-object-name doc-module-name">docforge.servers.mcp_server</span>
 
 
 </h2>
@@ -1149,26 +1056,28 @@
 
 
 
-
+<h3 id="docforge.servers.mcp_server-classes">Classes</h3>
 
 <div class="doc doc-object doc-class">
 
 
 
-<h3 id="docforge.servers.mcp_server.MCPServer" class="doc doc-heading">
-            <span class="doc doc-object-name doc-class-name">MCPServer</span>
+<h4 id="docforge.servers.mcp_server.MCPServer" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-class"></code>            <span class="doc doc-object-name doc-class-name">MCPServer</span>
 
 
-</h3>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">MCPServer</span><span class="p">(</span><span class="n">mcp_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
-</code></pre></div>
+</h4>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">MCPServer</span><span class="p">(</span><span class="n">mcp_root</span><span class="p">:</span> <span class="n">Path</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
 
-      <p>MCP server for serving a pre-built MCP documentation bundle.</p>
+      <p>MCP server for serving a pre-generated documentation bundle.</p>
+<p>The server exposes documentation resources and diagnostic tools through
+MCP endpoints backed by JSON files generated by the MCP renderer.</p>
 
-      <p>Initialize the MCPServer.</p>
+      <p>Initialize the MCP server.</p>
 
 
 <p><span class="doc-section-title">Parameters:</span></p>
@@ -1189,7 +1098,9 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Path to the directory containing pre-built MCP JSON resources.</p>
+                <p>Directory containing the generated MCP documentation
+bundle (for example <code>index.json</code>, <code>nav.json</code>, and
+<code>modules/</code>).</p>
               </div>
             </td>
             <td>
@@ -1203,7 +1114,7 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>Name of the MCP server.</p>
+                <p>Identifier used for the MCP server instance.</p>
               </div>
             </td>
             <td>
@@ -1224,18 +1135,18 @@
 
 
 
-
+<h5 id="docforge.servers.mcp_server.MCPServer-functions">Functions</h5>
 
 <div class="doc doc-object doc-function">
 
 
-<h4 id="docforge.servers.mcp_server.MCPServer.run" class="doc doc-heading">
-            <span class="doc doc-object-name doc-function-name">run</span>
+<h6 id="docforge.servers.mcp_server.MCPServer.run" class="doc doc-heading">
+<code class="doc-symbol doc-symbol-heading doc-symbol-method"></code>            <span class="doc doc-object-name doc-function-name">run</span>
 
 
-</h4>
-<div class="doc-signature highlight"><pre><span></span><code><span class="nf">run</span><span class="p">(</span><span class="n">transport</span><span class="p">:</span> <span class="n">Literal</span><span class="p">[</span><span class="s1">&#39;stdio&#39;</span><span class="p">,</span> <span class="s1">&#39;sse&#39;</span><span class="p">,</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
-</code></pre></div>
+</h6>
+<div class="language-python doc-signature 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></pre></div></td><td class="code"><div><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1"></a><span class="nf">run</span><span class="p">(</span><span class="n">transport</span><span class="p">:</span> <span class="n">Literal</span><span class="p">[</span><span class="s1">&#39;stdio&#39;</span><span class="p">,</span> <span class="s1">&#39;sse&#39;</span><span class="p">,</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="s1">&#39;streamable-http&#39;</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kc">None</span>
+</span></code></pre></div></td></tr></table></div>
 
     <div class="doc doc-contents ">
 
@@ -1260,7 +1171,8 @@
             </td>
             <td>
               <div class="doc-md-description">
-                <p>MCP transport (default: streamable-http)</p>
+                <p>Transport mechanism used by the MCP server. Supported
+options include <code>stdio</code>, <code>sse</code>, and <code>streamable-http</code>.</p>
               </div>
             </td>
             <td>
@@ -1307,6 +1219,8 @@
             </div>
           
           
+  <script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>
+
 <script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>
         </div>
         
@@ -1344,7 +1258,7 @@
     
     
       
-      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.tabs", "navigation.expand", "navigation.top", "navigation.instant", "content.code.copy", "content.code.annotate"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
+      <script id="__config" type="application/json">{"base": "../..", "features": ["navigation.sections", "navigation.expand", "navigation.top", "navigation.instant", "navigation.tracking", "navigation.indexes", "content.code.copy", "content.code.annotate", "content.tabs.link", "content.action.edit", "search.highlight", "search.share", "search.suggest"], "search": "../../assets/javascripts/workers/search.973d3a69.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
     
     
       <script src="../../assets/javascripts/bundle.f55a23d4.min.js"></script>
diff --git a/libs/doc-forge/site/sitemap.xml.gz b/libs/doc-forge/site/sitemap.xml.gz
index b57afed64391a32d48b709518986dfffdc2a006c..ef3423ec38ece858df4782cc558257c24ab3803a 100644
GIT binary patch
delta 13
Ucmb=gXP58h;AqHNJ(0Zv03AsLWdHyG

delta 13
Ucmb=gXP58h;Ar?dV<LM603Wmj-2eap