From 12254d74955f841fc25f455e50f738e51be732e1 Mon Sep 17 00:00:00 2001
From: Nubenetes Bot <bot@nubenetes.com>
Date: Sat, 20 Jun 2026 19:57:38 +0200
Subject: [PATCH] revert: disable top nav tabs; group orientation pages under
 "Portal Guide"

The top tab bar forced Material to scope the left sidebar to the active
tab, which regressed the always-populated vertical nav. Revert
navigation.tabs (+ .sticky) so the left column behaves as before.

Apply the intended grouping in the (restored) left nav instead:
- New "Portal Guide" collapsible group: Topic Map, Methodology,
  Technical Tags, About.
- about.md is pulled out of its Architectural Foundations dimension
  (skipped in the generator's dimension loop) so it is not duplicated.
- Agentic Video Hub stays a prominent top-level group with its video
  subpages (no longer hidden in a tab-overflow "...more" menu).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 src/v2_optimizer.py | 21 +++++++++++++++------
 v2-mkdocs.yml       | 16 +++++++---------
 2 files changed, 22 insertions(+), 15 deletions(-)

diff --git a/src/v2_optimizer.py b/src/v2_optimizer.py
index 72f79ead..960d8a80 100644
--- a/src/v2_optimizer.py
+++ b/src/v2_optimizer.py
@@ -1784,13 +1784,15 @@ class V2VisionEngine:
                 "nav:",
                 "  - \"🔙 Back to V1 (Exhaustive)\": https://nubenetes.com/v1/",
                 "  - \"The 2026 Vision\": index.md",
-                # Topic Map is a collapsible hub for the three site-orientation
-                # pages (the map itself + how it's built + the tag index), with
-                # topic-map.md as its section index (navigation.indexes).
-                "  - \"Topic Map\":",
-                "    - topic-map.md",
+                # Portal Guide: collapsible hub for the site-orientation / meta
+                # pages — the topic directory, how the portal is curated, the tag
+                # index and the project About. about.md is pulled out of its
+                # Architectural Foundations dimension here (see _FIXED_PAGES below).
+                "  - \"Portal Guide\":",
+                "    - \"Topic Map\": topic-map.md",
                 "    - \"Methodology\": methodology.md",
                 "    - \"Technical Tags\": tags.md",
+                "    - \"About\": about.md",
                 # Videos: prominent top-level dropdown, kept high in the nav with
                 # its category subpages as children.
                 "  - \"Agentic Video Hub\":",
@@ -1804,14 +1806,21 @@ class V2VisionEngine:
                 "    - \"Industry & Geo Digest\": industry-digest.md"
             ]
 
+            # Topic pages promoted into a fixed header group above; skip them in
+            # the dimension loop so they are not also listed under their dimension.
+            _FIXED_PAGES = {"about.md"}
+
             dim_groups = {}
             for f_name, info in data.items():
                 dim_groups.setdefault(info["dim"], []).append(f_name)
 
             for dim in self.dimensions.keys():
                 if dim in dim_groups:
+                    dim_files = [f for f in sorted(dim_groups[dim]) if f not in _FIXED_PAGES]
+                    if not dim_files:
+                        continue
                     dim_nav = [f"  - \"{dim}\":"]
-                    for f in sorted(dim_groups[dim]):
+                    for f in dim_files:
                         dim_nav.append(f"    - \"{data[f]['title']}\": {f}")
                     nav.extend(dim_nav)
 
diff --git a/v2-mkdocs.yml b/v2-mkdocs.yml
index 5d2612e4..d260eb2c 100644
--- a/v2-mkdocs.yml
+++ b/v2-mkdocs.yml
@@ -29,12 +29,10 @@ theme:
         icon: material/shield-moon-outline
         name: Switch to dark mode
   features:
-    # navigation.tabs: top-level sections render as a top tab bar AND the left
-    # sidebar stays, scoped to the active tab. With ~16 top-level sections the
-    # bar can overflow on narrow viewports; Material handles that with a
-    # horizontal scroll, and .sticky keeps the bar pinned while scrolling.
-    - navigation.tabs
-    - navigation.tabs.sticky
+    # navigation.tabs / .sticky disabled: a top tab bar forces Material to scope
+    # the left sidebar to the active tab only, which breaks the always-populated
+    # vertical list we want. The left sidebar handles all sections as a standard
+    # collapsible list and stays populated on every page incl. home.
     - navigation.top
     - navigation.tracking
     # navigation.sections disabled: render top-level as COLLAPSIBLE nested
@@ -157,10 +155,11 @@ markdown_extensions:
 nav:
   - "🔙 Back to V1 (Exhaustive)": https://nubenetes.com/v1/
   - "The 2026 Vision": index.md
-  - "Topic Map":
-    - topic-map.md
+  - "Portal Guide":
+    - "Topic Map": topic-map.md
     - "Methodology": methodology.md
     - "Technical Tags": tags.md
+    - "About": about.md
   - "Agentic Video Hub":
     - videos/index.md
     - "AI Agents and MCP": videos/ai-agents.md
@@ -176,7 +175,6 @@ nav:
     - "ChatGPT": chatgpt.md
     - "MLOps": mlops.md
   - "Architectural Foundations":
-    - "About": about.md
     - "Cheatsheets": cheatsheets.md
     - "Cloud Arch Diagrams": cloud-arch-diagrams.md
     - "Cloud Asset Inventory": cloud-asset-inventory.md