From 1717b1399f3e2a7fc7b0eeba9cea006d88876200 Mon Sep 17 00:00:00 2001 From: PatternCatalyst Date: Fri, 23 Oct 2026 07:23:23 -0400 Subject: [PATCH] docs(site): chrome, nav parity, and rule-14 cleanup - Nav parity with the sibling sites: rename "Tutorial" to "Chapters" and drop the extra "Prerequisites" nav item (its page stays, reached from Examples), matching Chapters | Examples | Bibliography | GitHub. - Rule 14: remove the /plans/iteration-plan roadmap links from the footer and the part-index "coming soon" callout; set the plans collection to output: false so internal planning docs no longer render. - Voice: recast every em dash in chrome (title separator to a middot, layout and include comments, index stat labels, the examples-page description and its legend marker). bibliography.md and the examples matrix table already match the sibling shape; no content changed, only punctuation and the not-applicable legend glyph. validate_site.py clean; voice-scan 0 ban-tier; Jekyll build green; /plans/ gone. --- _config.yml | 2 +- _example_pages/index.md | 6 +++--- _includes/codetabs.html | 2 +- _includes/excalidraw.html | 2 +- _includes/footer.html | 2 +- _includes/header.html | 4 +--- _layouts/default.html | 6 +++--- _layouts/part_index.html | 6 ++---- index.html | 6 +++--- 9 files changed, 16 insertions(+), 20 deletions(-) diff --git a/_config.yml b/_config.yml index 9a7d0818..53e41cd6 100644 --- a/_config.yml +++ b/_config.yml @@ -41,7 +41,7 @@ collections: output: true permalink: /docs/:name/ plans: - output: true + output: false permalink: /plans/:name/ example_pages: output: true diff --git a/_example_pages/index.md b/_example_pages/index.md index de8f6073..ac58391d 100644 --- a/_example_pages/index.md +++ b/_example_pages/index.md @@ -1,6 +1,6 @@ --- title: "Runnable Examples" -description: "Twenty-one runnable examples demonstrating cloud-native patterns in six language stacks — each with automated verification." +description: "Twenty-one runnable examples demonstrating cloud-native patterns in six language stacks, each with automated verification." marker: "▶" label: "Examples" permalink: /examples/ @@ -63,9 +63,9 @@ for install instructions. | 26 | [Failure Modes]({{ '/docs/26-appendix-m-failure-modes/' | relative_url }}) | Timeout, retry, circuit breaker, bulkhead, fallback | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Docker | | 27 | [Feature Flags]({{ '/docs/27-appendix-n-feature-flags/' | relative_url }}) | OpenFeature + flagd, targeting rules, rollout | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | Docker | | 28 | [Newman API Testing]({{ '/docs/28-appendix-o-newman/' | relative_url }}) | Postman collection runner, schema validation, CI | n/a | n/a | n/a | n/a | n/a | n/a | Docker | -| 30 | [Blazor Server + SignalR]({{ '/docs/30-appendix-q-blazor-signalr/' | relative_url }}) | Real-time dashboard with SignalR circuit and Redis backplane | — | — | — | ✓ | — | — | Docker | +| 30 | [Blazor Server + SignalR]({{ '/docs/30-appendix-q-blazor-signalr/' | relative_url }}) | Real-time dashboard with SignalR circuit and Redis backplane | ✗ | ✗ | ✗ | ✓ | ✗ | ✗ | Docker | -**Legend:** ✓ = available, — = not applicable (language-specific example), n/a = language-agnostic (no application code) +**Legend:** ✓ = available, ✗ = not applicable (language-specific example), n/a = language-agnostic (no application code) --- diff --git a/_includes/codetabs.html b/_includes/codetabs.html index 20bd8438..c715c66c 100644 --- a/_includes/codetabs.html +++ b/_includes/codetabs.html @@ -4,7 +4,7 @@ Emits an empty marker; assets/js/codetabs.js absorbs the next N fenced code blocks (N = number of pipe-separated labels) into an accessible tab group. Because the code blocks stay ordinary Markdown fences, Rouge - still highlights them at build time — no plugin required. + still highlights them at build time, no plugin required. Usage (place the marker, then one fenced block per label, IN THIS ORDER): diff --git a/_includes/excalidraw.html b/_includes/excalidraw.html index 5d7d1215..d7d03391 100644 --- a/_includes/excalidraw.html +++ b/_includes/excalidraw.html @@ -5,7 +5,7 @@ {% include excalidraw.html file="05-ebpf-load-attach" alt="Diagram showing how an eBPF program is loaded and attached" - caption="Figure 5.1 — Load, verify, attach" %} + caption="Figure 5.1: Load, verify, attach" %} Expects two files under assets/diagrams/: .excalidraw ← editable source (Excalidraw v2 JSON) diff --git a/_includes/footer.html b/_includes/footer.html index 2ca15760..cd3b6429 100644 --- a/_includes/footer.html +++ b/_includes/footer.html @@ -10,7 +10,7 @@

The book

diff --git a/_includes/header.html b/_includes/header.html index 7bac72e5..6d709244 100644 --- a/_includes/header.html +++ b/_includes/header.html @@ -6,9 +6,7 @@