Full category-driven reorganization of the quick-nav per the agreed taxonomy:
one direct pill (Topic Map) + 11 thematic dropdowns that group related topics
together so every destination has a sensible home.
Digest · Kubernetes (Overview · Docker · Tools · Helm · kubectl · all
kubernetes-* · Managed · OpenShift · Rancher) · Delivery (GitOps · CI/CD ·
DevOps · Argo · Flux · Tekton · Jenkins · …) · IaC (Terraform · IaC · Ansible
· Pulumi · Crossplane · Kustomize) · Cloud (AWS ▸ nested submenu · Azure · GCP
· Serverless · FinOps · Edge · …) · Network · Security · Observability & SRE ·
AI & Data · Dev & Platform · More
- Docker now lives inside Kubernetes; CI/CD + GitOps + DevOps share Delivery;
Terraform + IaC share the IaC menu (as requested).
- AWS is a NESTED submenu inside Cloud (Cloud → AWS ▸ → 8 AWS pages), built with
nested Popover API + explicit anchor() side-positioning (position-area's
horizontal axis isn't honored when the anchor is inside another popover;
left:anchor(right)/top:anchor(top) fixes it). Submenu keeps the parent open;
flip-inline fallback near the right edge.
- Pages may appear in more than one menu where it aids discovery.
- Menus get max-height:82vh + overflow-y for the tall Kubernetes menu.
Verified in Chrome 148 (Playwright): all 11 menus open below + fit viewport; the
AWS submenu opens to the side with the parent kept open; bar stays one row to
1280px. Cache-bust ?v=2.9.36. V2-only.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Audit of fragmentation found only two prefix clusters: aws (fixed in v2.9.34)
and kubernetes. Unlike AWS, kubernetes is well-classified — a rich parent (157
links) with substantial, distinct children (tools 144, networking 64, security
52, monitoring 24, storage 14, autoscaling 13, ...), not 1-3 link stubs. So
NOTHING is merged for kubernetes; this only adds a 'Deep-Dive Topic Pages' hub
to kubernetes.md indexing its 14 substantial sub-pages (Tools · Networking ·
Security · Monitoring · Storage · Autoscaling · Operators · Alternatives ·
Big Data · Tutorials · Backup & Migrations · Client Libraries · Local Dev ·
On-Premise) — purely additive navigation, no merging, no pruning.
Other small pages (pulumi, kustomize, registries, angular, ...) are legitimate
distinct topics, not fragments of a parent, so they are intentionally left
alone. Verified with --render-only; generator-only, CI republishes.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The AWS landing page rendered with only ~3 links because AWS content was split
across ~20 granular pages (Azure/GCP use a single rich page each), and many AWS
sub-pages had just 1-5 links. Two generator changes fix this:
A. Provider hub: aws.md now renders a 'Deep-Dive Topic Pages' index linking to
the substantial AWS sub-pages that remain (Serverless · Storage · Networking
· Security · IaC · Backup · New Features), via a new self.subpage_hubs map.
So the landing is a navigable index instead of a stub.
B. Stub consolidation: the near-empty / junk-drawer AWS sub-pages (<=7 links,
plus 'miscellaneous') merge into aws.md via the existing merge_map mechanism
(aws-miscellaneous, aws-databases, aws-devops, aws-containers, aws-monitoring,
aws-architecture, aws-tools-scripts, aws-messaging, aws-data, aws-training,
aws-pricing). Those slugs are also removed from self.dimensions so the full
pipeline prunes the orphaned pages and auto-syncs the nav.
Verified locally with --render-only: aws.md goes from 3 to 44 links plus the
7-child hub block; V1 (docs/) is untouched by design — it stays the exhaustive
archive and is still read as the merge source. No regenerated v2-docs or
inventory committed (CI republishes per the generator→republish pattern).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Data-driven expansion (ranked by per-page link count + relevance):
- New 📊 Digest menu: Tech & Cloud Digest + Industry & Geo Digest (was a single
pill; now pairs both editions).
- New 🧰 K8s menu: Kubernetes Tools (144 links) · Helm · Managed K8s · OpenShift
· Tutorials — the Kubernetes ecosystem, which the portal is centered on.
- ☁️ Cloud += Serverless · FinOps.
- 🌐 Network += Service Mesh (the category alongside Istio; Istio emoji → ⛵).
- ⚙️ Ops += IaC · Developer Portals.
- ⋯ More += Technical Tags (1355 links) · Demos (102).
38 destinations total across 6 direct pills + 7 Popover menus. Added explicit
anchor pairs for the two new menus. Chip font trimmed to 0.62rem + tighter
gap/padding so all 13 bar chips still fit one row down to ~1280px. Verified in
Chrome 148 via Playwright: all 7 menus open below their button, stay on-screen
(right-edge flip), and close on Esc. Cache-bust ?v=2.9.33. V2-only.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Two fixes to the hybrid quick-nav shipped in v2.9.31:
1. Popover menus did not visibly open on click. Root cause: the menus used
`position-area: bottom span-inline-end`, which mixes a physical keyword
(bottom) with a logical one (span-inline-end) — invalid, so it computed to
`none` and the menu fell back to its static position on top of the button.
Additionally the popover's implicit anchor was not resolving. Fixed by using
a valid all-physical `position-area: bottom span-right` and declaring explicit
anchor-name / position-anchor pairs per button↔menu, so each menu reliably
drops below its trigger and auto-flips (span-left) near the right edge.
Verified in Chrome 148 via Playwright: all five menus open on real click,
render below the button, stay within the viewport, and close on Escape.
2. The bar wrapped to a second row at common widths. Reduced the chip font
~1pt (0.7rem → 0.64rem) and trimmed the column-gap/padding so all 7 pills +
5 menus fit a single row down to 1280px viewports.
Bumps v2_elite.css cache-bust to ?v=2.9.32. V2-only, template/CSS only.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Collapses the 25-destination quick-nav from 3 wrapped rows to a single slim row
that stays one row regardless of how many destinations are added.
Structure:
- 7 direct one-click pills for the most-used flagships: Topic Map, Digest,
Kubernetes, Docker, GitOps, Terraform, AI & MCP.
- 5 category menus for the long tail, built with the native HTML Popover API +
CSS Anchor Positioning (Baseline 2026), zero JS:
☁️ Cloud (AWS · Azure · GCP) · 🌐 Network (Networking · Istio · K8s Net)
· 🔐 Security (K8s Security · DevSecOps)
· ⚙️ Ops (CI/CD · Observability · SRE · DevOps)
· ⋯ More (Videos · Ansible · Messaging · MLOps · Methodology · V1 Archive)
Why this design: keeps the hot paths at one click (the project's whole value),
while the rarely-used clusters fold away — so the bar never grows past one row.
Popover API gives free Esc / click-outside dismissal and focus management and
works identically on touch and desktop; menus drop below their button via
position-area with flip fallbacks, animate in via @starting-style, and rotate
their caret using :has(). prefers-reduced-motion honored. All 25 destinations
preserved. Bumps v2_elite.css cache-bust to ?v=2.9.31. V2-only.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Grows the quick-nav bar to 25 destinations:
- New networking cluster (after cloud): 🌐 Networking · 🕸️ Istio · 🔗 K8s Net
- DevSecOps joins the security cluster: 🔐 Security · 🛡️ DevSecOps
Short labels as usual (K8s Net for Kubernetes Networking). Template-only change
to docs/overrides/main.html; reuses the existing .nb-quicknav pill styling, no
CSS change, no page regeneration, V2-only. All target pages verified and
mkdocs build -f v2-mkdocs.yml passes with all 25 links rendering.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
