Skip to content

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

Merged
IanMayo merged 3 commits into
mainfrom
ccr-eb36b8e2-yhrk02
Oct 31, 2026
Merged

IanMayo merged 3 commits into
mainfrom
ccr-eb36b8e2-yhrk02

Conversation

@IanMayo

@IanMayo IanMayo commented Oct 31, 2026

Copy link
Copy Markdown
Contributor

Follow-up to #100.

Walkthrough

docs/walkthrough/ is a slide deck that walks through the student and instructor journeys. It has 25 slides, 20 annotated screenshots and a sample CSV export.

  • It needs no external libraries or fonts.
  • Navigate with the arrow keys, space, swipe or #n links.
  • Each numbered box on a screenshot matches a caption, and the captions cite SRD 013 requirement IDs where they apply.

Where it is published:

  • main: https://DeepBlueCLtd.github.io/BrowserTest/main/walkthrough/ (added to pages.yml)
  • PRs: /pr-<n>/walkthrough/ (added to pr-preview.yml; the preview comment links both)

To regenerate the screenshots, run npm run build:dita:plain && npm run walkthrough:capture, then git checkout -- dita-demo. scripts/capture-walkthrough.mjs drives dita-demo/ with Playwright and records where each highlighted element sits. This is documented in docs/MAINTAINERS.md.

The deck adds about 1.6 MB of PNGs to the repo.

Known gap: the demo output still has the search box. The capture hides it so the screenshots match the new template, and the intro slide says so.

Fixes found while capturing (tests first)

  • Logout prompt missing: after logout, quiz pages did not show "log in to answer". The coordinator's reset removed the listener before it could show the notice.
  • Phantom answers: the scores modal and the CSV listed the empty placeholder records that pad skipped questions as answers.
  • Overflowing messages: login messages overflowed the panel because they lacked box-sizing: border-box.

Verification

Check Result
typecheck, lint, format pass
Unit 1016 passed
Integration 94 passed
Build and size check pass
E2E, plain storage 116 passed, 6 skipped (as before)
Deck check 25 slides, all images and annotations present, no console errors, no overflow at phone width

The encrypted-storage E2E mode was not re-run locally; CI runs it.


Generated by Claude Code

- Quiz table: show the "log in to answer" prompt after logout. The
  coordinator's reset removed the logout listener before it could
  show the notice.
- Scores modal and CSV export: skip the empty placeholder records
  that pad skipped questions, so they no longer appear as answers.
- Login form: messages use border-box sizing so they do not overflow
  the panel.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019erPampkiqiri3Gab6oSHB
docs/walkthrough/ is a self-contained slide deck (no external
libraries or fonts) that walks through the student and instructor
journeys with 20 annotated screenshots and a sample CSV export.

- scripts/capture-walkthrough.mjs (npm run walkthrough:capture)
  drives dita-demo with Playwright and records the screenshots plus
  the annotation boxes for each highlighted element.
- pages.yml publishes it at /main/walkthrough/; pr-preview.yml at
  /pr-<n>/walkthrough/, and the preview comment links both.
- ESLint ignores the generated img/shots.js.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_019erPampkiqiri3Gab6oSHB
@github-actions

Copy link
Copy Markdown
Contributor

🚀 PR Preview Deployment

✅ Your changes are being built and deployed to a preview environment.

📋 Live PR Preview Links:

ℹ️ About PR Previews:

📦 Production Demo (main branch):

🧪 Testing Locally:

npm install
npm run build
# Open demo/quiz-index.html in your browser (use file:// or http-server)

This comment will be automatically updated when you push new commits.

github-actions Bot added a commit that referenced this pull request Oct 31, 2026
@IanMayo
IanMayo merged commit 47d5cda into main Oct 31, 2026
9 checks passed
@IanMayo
IanMayo deleted the ccr-eb36b8e2-yhrk02 branch October 31, 2026 19:34
github-actions Bot added a commit that referenced this pull request Oct 31, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants