docs: bring docforge docstrings and wiki to GSDFC standard

- fix GSDFC spec contradictions in __init__ docstring (parenthesized types, fenced-block rule) and sync generated README
- rewrite docstrings across loaders, models, nav, servers, renderers, cli; sync .pyi stubs
- add pydoclint (google style) gate to dev extras and pyproject config
- fix mcp nav resources doc:// -> docs://
- refresh docs/lib and docs/mcp, drop stale docforge/ duplicate group
- update wiki pages and add GSDFC + MCP guides under 05_development

docforge/nav/resolver.py

@@ -3,6 +3,14 @@ Navigation resolution utilities.
 
 This module resolves a ``NavSpec`` against the filesystem by expanding glob
 patterns and validating that referenced documentation files exist.
+
+---
+
+Notes:
+    - Glob resolution is recursive and returns paths in sorted order.
+    - Unmatched patterns raise ``FileNotFoundError`` to fail fast on typos.
+
+---
 """
 
 import glob
@@ -35,9 +43,12 @@ class ResolvedNav:
         Initialize a ResolvedNav instance.
 
         Args:
-            home: Relative path to the home page within the documentation root.
-            groups: Mapping of group titles to resolved documentation file paths.
-            docs_root: Root directory of the documentation source files.
+            home (str | None):
+                Relative path to the home page within the documentation root.
+            groups (dict[str, list[Path]]):
+                Mapping of group titles to resolved documentation file paths.
+            docs_root (Path | None):
+                Root directory of the documentation source files.
         """
         self.home = home
         self.groups = groups
@@ -47,8 +58,10 @@ class ResolvedNav:
         """
         Iterate over all files referenced by the navigation structure.
 
-        Returns:
-            An iterable of ``Path`` objects representing documentation files.
+        Yields:
+            Path:
+                A documentation file referenced by the navigation, including
+                the home page when defined.
 
         Raises:
             RuntimeError: If the home page is defined but the documentation
@@ -74,11 +87,14 @@ def resolve_nav(
     that referenced documentation files exist within the documentation root.
 
     Args:
-        spec: Navigation specification describing documentation layout.
-        docs_root: Root directory containing documentation Markdown files.
+        spec (NavSpec):
+            Navigation specification describing documentation layout.
+        docs_root (Path):
+            Root directory containing documentation Markdown files.
 
     Returns:
-        A ``ResolvedNav`` instance containing validated navigation paths.
+        ResolvedNav:
+            A `ResolvedNav` instance containing validated navigation paths.
 
     Raises:
         FileNotFoundError: If the documentation root does not exist or a
@@ -92,10 +108,12 @@ def resolve_nav(
         Resolve a glob pattern relative to the documentation root.
 
         Args:
-            pattern: Glob pattern used to match documentation files.
+            pattern (str):
+                Glob pattern used to match documentation files.
 
         Returns:
-            A sorted list of matching ``Path`` objects.
+            list[Path]:
+                A sorted list of matching `Path` objects.
 
         Raises:
             FileNotFoundError: If the pattern does not match any files.