Skip to content

cp-j0gw.15: plain-language standalone explainer pages (M01, M03, M18) - #5

Open
AJBcoding wants to merge 1 commit into
mainfrom
cp-j0gw.15-plain-lang-explainers
Open

cp-j0gw.15: plain-language standalone explainer pages (M01, M03, M18)#5
AJBcoding wants to merge 1 commit into
mainfrom
cp-j0gw.15-plain-lang-explainers

Conversation

@AJBcoding

Copy link
Copy Markdown
Owner

Summary

Three narrative-paced standalone explainer pages, sized between the
in-flight /learn/ panels and the M-doc corpus source:

  • web/explainers/M01.html — cohort floor + AHEAD-published-flag override
  • web/explainers/M03.html — lowest-of-three benchmark routing
  • web/explainers/M18.html — § 668.16(t) five-frame convergence

Each page mirrors the public-data-badge + top-disclaimer patterns,
ends with a 'Verify against primary sources' callout linking to
/sources.html, and threads breadcrumb navigation back to
/index.html and /learn.html.

web/css/explainers.css carries the shared pattern styles standalone
so the pages render without depending on learn.css (introduced in
the parallel cp-0on-ext-senate-plain-lang branch).

Coordination note — learn.html linking

The bead asks for 'Read the full plain-language explainer →' links from
learn.html's M01/M03/M18 sections. learn.html is introduced in
cp-0on-ext-senate-plain-lang and is not yet on main. Per the bead's
directive to base off main (not cp-0on), this PR ships the explainer
pages standalone and merge-ready. The learn.html linking patch is a
follow-up once cp-0on lands.

Test plan

  • npm test — 218/218 vitest pass (was 197 + 21 new explainer
    structural tests in tests/ui/explainers.test.ts)
  • npm run typecheck — clean
  • npm run lint:glossary — clean across content/ and web/
    (no forbidden literals; no condescending voice)
  • Manual: load each page in a browser to verify breadcrumb,
    disclaimer rendering, callout link, and sources.html deep links

Three narrative-paced standalone explainers, sized between the
/learn/ panels and the M-doc source:

- web/explainers/M01.html — cohort floor + AHEAD-published-flag override
- web/explainers/M03.html — lowest-of-three benchmark routing
- web/explainers/M18.html — § 668.16(t) five-frame convergence

Each page mirrors the public-data-badge + top-disclaimer patterns
(rendered standalone via web/css/explainers.css, no dependency on
learn.css), ends with a 'Verify against primary sources' callout
linking to /sources.html, and threads breadcrumb navigation back
to /index.html and /learn.html.

Also adds tests/ui/explainers.test.ts — 21 structural assertions
verifying every page carries the shared patterns and the topic-
specific anchor headings + sources-page citations.

Note on linking from learn.html: learn.html is introduced in the
in-flight cp-0on-ext-senate-plain-lang branch, not yet on main.
Per the bead's directive to base off main (not cp-0on), the
explainer pages are merge-ready standalone; the learn.html
'Read the full plain-language explainer →' links are a follow-up
patch once cp-0on lands.

Glossary-linter clean (no forbidden literals or condescending
voice). 218/218 vitest pass (was 197, +21 new explainer
structural tests). Typecheck clean.
AJBcoding added a commit that referenced this pull request May 5, 2026
Adds three new sections to the changelog reflecting the 2026-05-05
evening polecat-return wave and chair-review track:

1. "Stacked PR record" — table of all 5 PRs (#1-#5) with branches,
   beads, authors, and post-merge test counts. Suggested chair
   merge order: #1 -> #3 -> #2 -> #4 -> #5.

2. Sub-bead ledger refreshed: cp-j0gw.8, .11, .13, .14, .15 all
   marked done with PR pointers; cp-j0gw.16 deferred until preview
   URL is live.

3. "Chair-review track applied" — the 4 reviews iterated inline this
   evening (#1 disclaimers approved, #2 systemwide refined, #3
   groupings applied, #4 prose skipped + bug fix shipped). #5
   comment-outline review not yet run.

4. "Smoke-stack record" — verifies all 5 PRs merge cleanly in order
   with one trivial conflict (web/index.html persona-card stack).
   Final stacked test count: 249/249. Production lint scan caught
   3 dean-facing literal violations (OPEID6 + cascade) in PR #1's
   surfaces; fixed in commit 0993045. PR #2 (obsidian widget) has
   one analogous "cascade" literal in link text — surfaced as
   follow-up note.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
AJBcoding added a commit that referenced this pull request May 5, 2026
Stacked PR record updated:
- 6 PRs now open (added PR #6, quartz batch-2 explainers M04/M07/M14)
- PR #2 carries obsidian's cp-j0gw.17 lint fix (commit 38e236c)
- Final stacked test count: 270/270
- Suggested chair merge order: #1 -> #3 -> #2 -> #4 -> #5 -> #6
- Broader lint scan: 0 OPEID6/cascade violations remaining; only
  formal cite names (STATS NPRM, RIA Table 3.19) kept per M-doc
  convention.

Sub-bead ledger: cp-j0gw.17 + cp-j0gw.18 marked done with PR pointers.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
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.

1 participant