Copilot · May 20, 2026 · May 20, 2026 · May 20, 2026 · May 20, 2026 · May 20, 2026
diff --git a/.github/workflows/build-deploy.yml b/.github/workflows/build-deploy.yml
@@ -1,4 +1,4 @@
-name: Build / Deploy to GH Pages
+name: Build / Validate
 
 on:
   workflow_dispatch:
@@ -32,9 +32,3 @@ jobs:
 
     - name: 🏗️ Generate Site
       run: dotnet run --property:Configuration=Release --project src/dotnetbyexample/dotnetbyexample.csproj 
-
-    - name: 🚀 Deploy Code Coverage Report
-      uses: JamesIves/github-pages-deploy-action@v4.8.0
-      with:
-        branch: gh-pages
-        folder: site
diff --git a/.github/workflows/deploy-pages.yml b/.github/workflows/deploy-pages.yml
@@ -0,0 +1,42 @@
+name: Deploy GH Pages
+
+on:
+  workflow_dispatch:
+  push:
+    branches: [ main, dev ]
+    paths:
+      - src/**
+      - examples/**
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: 🛎️ Checkout
+      uses: actions/checkout@v6
+
+    - name: ⚙️ Setup .NET 10.0
+      uses: actions/setup-dotnet@v5
+      with:
+        dotnet-version: '10.0.x'
+
+    - name: ⬇️ Restore dependencies
+      run: dotnet restore
+      working-directory: src
+
+    - name: 🔨 Build
+      run: dotnet build --configuration Release --no-restore
+      working-directory: src
+
+    - name: 🏗️ Generate Site
+      run: dotnet run --property:Configuration=Release --project src/dotnetbyexample/dotnetbyexample.csproj
+
+    - name: 🚀 Deploy Site
+      uses: JamesIves/github-pages-deploy-action@v4.8.0
+      with:
+        branch: gh-pages
+        folder: site
diff --git a/README.md b/README.md
@@ -50,6 +50,7 @@ Locally
 ## docs
 
 - 📂[docs](docs/README.md)
+- 📄[figures](docs/figures.md) — how to add inline SVG diagrams to example pages
 
 ## Dependencies
 

diff --git a/docs/figure-arrays.png b/docs/figure-arrays.png
diff --git a/docs/figure-atomic-counters.png b/docs/figure-atomic-counters.png
diff --git a/docs/figure-base64-encoding.png b/docs/figure-base64-encoding.png
diff --git a/docs/figure-channel-buffering.png b/docs/figure-channel-buffering.png
diff --git a/docs/figure-channel-directions.png b/docs/figure-channel-directions.png
diff --git a/docs/figure-channel-synchronization.png b/docs/figure-channel-synchronization.png
diff --git a/docs/figure-channels.png b/docs/figure-channels.png
diff --git a/docs/figure-closing-channels.png b/docs/figure-closing-channels.png
diff --git a/docs/figure-closures.png b/docs/figure-closures.png
diff --git a/docs/figure-command-line-arguments.png b/docs/figure-command-line-arguments.png
diff --git a/docs/figure-command-line-flags.png b/docs/figure-command-line-flags.png
diff --git a/docs/figure-command-line-subcommands.png b/docs/figure-command-line-subcommands.png
diff --git a/docs/figure-constants.png b/docs/figure-constants.png
diff --git a/docs/figure-context.png b/docs/figure-context.png
diff --git a/docs/figure-custom-errors.png b/docs/figure-custom-errors.png
diff --git a/docs/figure-defer.png b/docs/figure-defer.png
diff --git a/docs/figure-directories.png b/docs/figure-directories.png
diff --git a/docs/figure-embed-directive.png b/docs/figure-embed-directive.png
diff --git a/docs/figure-enums.png b/docs/figure-enums.png
diff --git a/docs/figure-environment-variables.png b/docs/figure-environment-variables.png
diff --git a/docs/figure-epoch.png b/docs/figure-epoch.png
diff --git a/docs/figure-errors.png b/docs/figure-errors.png
diff --git a/docs/figure-execing-processes.png b/docs/figure-execing-processes.png
diff --git a/docs/figure-exit.png b/docs/figure-exit.png
diff --git a/docs/figure-file-paths.png b/docs/figure-file-paths.png
diff --git a/docs/figure-for.png b/docs/figure-for.png
diff --git a/docs/figure-functions.png b/docs/figure-functions.png
diff --git a/docs/figure-generics.png b/docs/figure-generics.png
diff --git a/docs/figure-goroutines.png b/docs/figure-goroutines.png
diff --git a/docs/figure-hello-world.png b/docs/figure-hello-world.png
diff --git a/docs/figure-http-client.png b/docs/figure-http-client.png
diff --git a/docs/figure-http-server.png b/docs/figure-http-server.png
diff --git a/docs/figure-if-else.png b/docs/figure-if-else.png
diff --git a/docs/figure-interfaces.png b/docs/figure-interfaces.png
diff --git a/docs/figure-json.png b/docs/figure-json.png
diff --git a/docs/figure-line-filters.png b/docs/figure-line-filters.png
diff --git a/docs/figure-logging.png b/docs/figure-logging.png
diff --git a/docs/figure-maps.png b/docs/figure-maps.png
diff --git a/docs/figure-methods.png b/docs/figure-methods.png
diff --git a/docs/figure-multiple-return-values.png b/docs/figure-multiple-return-values.png
diff --git a/docs/figure-mutexes.png b/docs/figure-mutexes.png
diff --git a/docs/figure-non-blocking-channel-operations.png b/docs/figure-non-blocking-channel-operations.png
diff --git a/docs/figure-number-parsing.png b/docs/figure-number-parsing.png
diff --git a/docs/figure-panic.png b/docs/figure-panic.png
diff --git a/docs/figure-plan.md b/docs/figure-plan.md
@@ -0,0 +1,108 @@
+# Figure Plan
+
+Tracks which example pages have a visual figure banner and which still need one.
+
+A figure is added by:
+
+1. Writing a paint method in `src/dotnetbyexample/Marginalia/Figures.cs`.
+2. Registering it in `Figures.Registry` (same file).
+3. Adding an entry to `FigureAttachments.Attachments` in `src/dotnetbyexample/Marginalia/FigureAttachments.cs`.
+
+---
+
+## Progress
+
+84 of 84 examples have figures (0 remaining).
+
+| Example | Figure | Status |
+|---|---|---|
+| `arrays` | `array-index` | ✅ done |
+| `atomic-counters` | `atomic-counter-sync` | ✅ done |
+| `base64-encoding` | `base64-roundtrip` | ✅ done |
+| `channel-buffering` | `channel-buffering-cap` | ✅ done |
+| `channel-directions` | `channel-directions` | ✅ done |
+| `channel-synchronization` | `channel-sync` | ✅ done |
+| `channels` | `channel-buffer` | ✅ done |
+| `closing-channels` | `channel-close-range` | ✅ done |
+| `closures` | `closure-cell` | ✅ done |
+| `command-line-arguments` | `cli-args-slice` | ✅ done |
+| `command-line-flags` | `cli-flags-parse` | ✅ done |
+| `command-line-subcommands` | `cli-subcommands` | ✅ done |
+| `constants` | `const-value` | ✅ done |
+| `context` | `context-cancel-tree` | ✅ done |
+| `custom-errors` | `custom-error-fields` | ✅ done |
+| `defer` | `lifo-defer` | ✅ done |
+| `directories` | `directory-tree` | ✅ done |
+| `embed-directive` | `embed-directive` | ✅ done |
+| `enums` | `enum-values` | ✅ done |
+| `environment-variables` | `env-key-values` | ✅ done |
+| `epoch` | `epoch-offset` | ✅ done |
+| `errors` | `exception-flow` | ✅ done |
+| `execing-processes` | `exec-process` | ✅ done |
+| `exit` | `exit-status` | ✅ done |
+| `file-paths` | `file-path-parts` | ✅ done |
+| `for` | `for-loop` | ✅ done |
+| `functions` | `function-call` | ✅ done |
+| `generics` | `generic-box` | ✅ done |
+| `goroutines` | `goroutine-lanes` | ✅ done |
+| `hello-world` | `console-writeline` | ✅ done |
+| `http-client` | `http-client-roundtrip` | ✅ done |
+| `http-server` | `http-server-listener` | ✅ done |
+| `if-else` | `if-else-branch` | ✅ done |
+| `interfaces` | `interface-contract` | ✅ done |
+| `json` | `json-serialize` | ✅ done |
+| `line-filters` | `line-filter` | ✅ done |
+| `logging` | `structured-log-entry` | ✅ done |
+| `maps` | `map-entries` | ✅ done |
+| `methods` | `method-slots` | ✅ done |
+| `multiple-return-values` | `multi-return` | ✅ done |
+| `mutexes` | `mutex-critical` | ✅ done |
+| `non-blocking-channel-operations` | `non-blocking-select` | ✅ done |
+| `number-parsing` | `number-parse-flow` | ✅ done |
+| `panic` | `panic-recover-stack` | ✅ done |
+| `pointers` | `ref-alias` | ✅ done |
+| `random-numbers` | `random-numbers` | ✅ done |
+| `range-over-built-in-types` | `range-runes` | ✅ done |
+| `range-over-channels` | `range-over-channels` | ✅ done |
+| `range-over-iterators` | `range-iterator` | ✅ done |
+| `rate-limiting` | `rate-limiter` | ✅ done |
+| `reading-files` | `read-file-buffer` | ✅ done |
+| `recover` | `recover-flow` | ✅ done |
+| `recursion` | `call-stack` | ✅ done |
+| `regular-expressions` | `regex-captures` | ✅ done |
+| `select` | `select-race` | ✅ done |
+| `sha256-hashes` | `sha256-digest` | ✅ done |
+| `signals` | `signal-channel` | ✅ done |
+| `slices` | `slice-window` | ✅ done |
+| `sorting` | `sort-before-after` | ✅ done |
+| `sorting-by-functions` | `sort-comparator` | ✅ done |
+| `spawning-processes` | `spawn-process-pipe` | ✅ done |
+| `stateful-goroutines` | `stateful-owner` | ✅ done |
+| `string-formatting` | `format-placeholders` | ✅ done |
+| `string-functions` | `string-ops` | ✅ done |
+| `strings-and-runes` | `string-rune-bytes` | ✅ done |
+| `struct-embedding` | `struct-embedding` | ✅ done |
+| `structs` | `struct-fields` | ✅ done |
+| `switch` | `switch-cases` | ✅ done |
+| `temp-files-and-directories` | `temp-file-lifecycle` | ✅ done |
+| `testing-and-benchmarking` | `test-benchmark-flow` | ✅ done |
+| `text-templates` | `text-template-render` | ✅ done |
+| `tickers` | `ticker-stream` | ✅ done |
+| `time` | `time-fields` | ✅ done |
+| `time-formatting-parsing` | `time-format-parse` | ✅ done |
+| `timeouts` | `timeout-select` | ✅ done |
+| `timers` | `timer-tick` | ✅ done |
+| `url-parsing` | `url-parts` | ✅ done |
+| `values` | `number-lines` | ✅ done |
+| `variables` | `variables-bind` | ✅ done |
+| `variadic-functions` | `params-array` | ✅ done |
+| `waitgroups` | `waitgroup-counter` | ✅ done |
+| `worker-pools` | `worker-pool` | ✅ done |
+| `writing-files` | `write-file-buffer` | ✅ done |
+| `xml` | `xml-roundtrip` | ✅ done |
+
+---
+
+## Suggested next batch
+
+All examples currently have figure coverage. No additional batch is pending.
diff --git a/docs/figure-pointers.png b/docs/figure-pointers.png
diff --git a/docs/figure-random-numbers.png b/docs/figure-random-numbers.png
diff --git a/docs/figure-range-over-built-in-types.png b/docs/figure-range-over-built-in-types.png
diff --git a/docs/figure-range-over-channels.png b/docs/figure-range-over-channels.png
diff --git a/docs/figure-range-over-iterators.png b/docs/figure-range-over-iterators.png
diff --git a/docs/figure-rate-limiting.png b/docs/figure-rate-limiting.png
diff --git a/docs/figure-reading-files.png b/docs/figure-reading-files.png
diff --git a/docs/figure-recover.png b/docs/figure-recover.png
diff --git a/docs/figure-recursion.png b/docs/figure-recursion.png
diff --git a/docs/figure-regular-expressions.png b/docs/figure-regular-expressions.png
diff --git a/docs/figure-select.png b/docs/figure-select.png
diff --git a/docs/figure-sha256-hashes.png b/docs/figure-sha256-hashes.png
diff --git a/docs/figure-signals.png b/docs/figure-signals.png
diff --git a/docs/figure-slices.png b/docs/figure-slices.png
diff --git a/docs/figure-sorting-by-functions.png b/docs/figure-sorting-by-functions.png
diff --git a/docs/figure-sorting.png b/docs/figure-sorting.png
diff --git a/docs/figure-spawning-processes.png b/docs/figure-spawning-processes.png
diff --git a/docs/figure-stateful-goroutines.png b/docs/figure-stateful-goroutines.png
diff --git a/docs/figure-string-formatting.png b/docs/figure-string-formatting.png
diff --git a/docs/figure-string-functions.png b/docs/figure-string-functions.png
diff --git a/docs/figure-strings-and-runes.png b/docs/figure-strings-and-runes.png
diff --git a/docs/figure-struct-embedding.png b/docs/figure-struct-embedding.png
diff --git a/docs/figure-structs.png b/docs/figure-structs.png
diff --git a/docs/figure-switch.png b/docs/figure-switch.png
diff --git a/docs/figure-temp-files-and-directories.png b/docs/figure-temp-files-and-directories.png
diff --git a/docs/figure-testing-and-benchmarking.png b/docs/figure-testing-and-benchmarking.png
diff --git a/docs/figure-text-templates.png b/docs/figure-text-templates.png
diff --git a/docs/figure-tickers.png b/docs/figure-tickers.png
diff --git a/docs/figure-time-formatting-parsing.png b/docs/figure-time-formatting-parsing.png
diff --git a/docs/figure-time.png b/docs/figure-time.png
diff --git a/docs/figure-timeouts.png b/docs/figure-timeouts.png
diff --git a/docs/figure-timers.png b/docs/figure-timers.png
diff --git a/docs/figure-url-parsing.png b/docs/figure-url-parsing.png
diff --git a/docs/figure-values.png b/docs/figure-values.png
diff --git a/docs/figure-variables.png b/docs/figure-variables.png
diff --git a/docs/figure-variadic-functions.png b/docs/figure-variadic-functions.png
diff --git a/docs/figure-waitgroups.png b/docs/figure-waitgroups.png
diff --git a/docs/figure-worker-pools.png b/docs/figure-worker-pools.png
diff --git a/docs/figure-writing-files.png b/docs/figure-writing-files.png
diff --git a/docs/figure-xml.png b/docs/figure-xml.png
-Original file line number
+Diff line change
@@ Expand Up / @@ -50,6 +50,7 @@ Locally @@
     ## docs
     - 📂[docs](docs/README.md)
+    - 📄[figures](docs/figures.md) — how to add inline SVG diagrams to example pages
     ## Dependencies
@@ Expand Down @@