Annotated slide walkthrough on GitHub Pages, plus three fixes it found

.github/workflows/pages.yml

@@ -44,6 +44,9 @@ jobs:
             exit 1
           fi
           cp -r dist _site/
+          # Slide walkthrough of the application, served at main/walkthrough/
+          mkdir -p _site/walkthrough
+          cp -r docs/walkthrough/* _site/walkthrough/
 
       - name: Checkout gh-pages branch
         uses: actions/checkout@v4

.github/workflows/pr-preview-comment.yml

@@ -29,6 +29,7 @@ jobs:
             **📋 Live PR Preview Links:**
             - 🌐 [DITA WebHelp Preview](https://${owner}.github.io/${repo}/pr-${prNumber}/)
             - 📚 [Storybook Preview](https://${owner}.github.io/${repo}/pr-${prNumber}/storybook/)
+            - 🎞️ [Walkthrough slides](https://${owner}.github.io/${repo}/pr-${prNumber}/walkthrough/)
 
             **ℹ️ About PR Previews:**
             - Preview deploys automatically when you push commits to this PR
@@ -40,6 +41,7 @@ jobs:
             - 🏠 [Quiz Index (Home)](https://${owner}.github.io/${repo}/main/quiz-index.html)
             - 📝 [Quiz Examples](https://${owner}.github.io/${repo}/main/quiz-examples.html)
             - 📊 [Analysis Examples](https://${owner}.github.io/${repo}/main/analysis-examples.html)
+            - 🎞️ [Walkthrough slides](https://${owner}.github.io/${repo}/main/walkthrough/)
 
             **🧪 Testing Locally:**
             \`\`\`bash

.github/workflows/pr-preview.yml

@@ -54,6 +54,11 @@ jobs:
             echo "⚠️ Warning: dita-demo not found, skipping DITA deployment"
           fi
 
+          # Slide walkthrough of the application
+          mkdir -p _site/pr-${PR_NUMBER}/walkthrough
+          cp -r docs/walkthrough/* _site/pr-${PR_NUMBER}/walkthrough/
+          echo "✅ Walkthrough copied to _site/pr-${PR_NUMBER}/walkthrough/"
+
           # Copy Storybook build to PR directory
           if [ -d "storybook-static" ]; then
             mkdir -p _site/pr-${PR_NUMBER}/storybook

docs/MAINTAINERS.md

@@ -60,6 +60,7 @@ The demo pages load `dist/sonar-quiz.iife.js` and provide the hidden config span
 | Published output | `npm run check:answer-leak -- dita/out/oxygen` | Manual, developer only: fails on plaintext answers before `update-dita-demo` |
 | E2E | `npm run test:e2e` and `npm run test:e2e:encrypted` | CI matrix |
 | Storybook build | `npm run build-storybook` | CI, on every push and PR |
+| Walkthrough slides | `npm run build:dita:plain && npm run walkthrough:capture` | Manual: re-captures the screenshots in `docs/walkthrough/img/`. Pages and PR previews publish `docs/walkthrough/` at `/main/walkthrough/` and `/pr-<n>/walkthrough/` |
 | Release | Tag `vX.Y.Z` on `main` | `release.yml` builds and publishes; see `docs/RELEASE.md`. Last release: `v0.2.0`, 2025-11-29. Bump `package.json` first — `VERSION` in the bundle is injected from it. |
 
 **Raising the ratchets.** The coverage thresholds and `--max-gaps` value are set to the measured