Skip to content

cp-j0gw.18: plain-language standalone explainer pages (M04, M07, M14) - #6

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

cp-j0gw.18: plain-language standalone explainer pages (M04, M07, M14)#6
AJBcoding wants to merge 1 commit into
cp-j0gw.15-plain-lang-explainersfrom
cp-j0gw.18-plain-lang-explainers-batch2

Conversation

@AJBcoding

Copy link
Copy Markdown
Owner

Summary

Three additional narrative-paced standalone explainer pages, extending
the cp-j0gw.15 set (PR#5 — M01/M03/M18). Same shared patterns as that
batch:

  • web/explainers/M04.html — pass/fail trigger + two-failures-in-three-
    years rule + four-year earnings lag
  • web/explainers/M07.html — first-failure disclosures under proposed
    § 668.43(d)(1); 2023 GE-rule procedural model; appeal/disclosure
    interaction
  • web/explainers/M14.html — named CIP families (50.05, 50.07, 50.09,
    51.15) per the Department's regulatory-impact analysis; recomputed
    elevation factors; structural-disparate-impact framing

Each page mirrors the cp-j0gw.15 patterns (public-data-badge,
top-disclaimer, breadcrumb, verify-callout linking to
/sources.html, explainer-nav between siblings) and renders standalone
via the existing web/css/explainers.css.

tests/ui/explainers.test.ts extended with the 3 new PAGES entries
(7 structural assertions per page = 21 new tests).

Branch base

This PR targets cp-j0gw.15-plain-lang-explainers (PR#5) — branching
from main directly was not viable because the bead asks to extend
tests/ui/explainers.test.ts, which only exists on the cp-j0gw.15
branch. The bead's directive to avoid cp-0on-ext-senate-plain-lang
is honored: this branch carries no senate-packet content. Once PR#5
lands on main, this PR rebases trivially onto main (no overlapping
file changes — only the test file's PAGES array is modified, additively).

learn.html linking

learn.html is in the in-flight cp-0on-ext-senate-plain-lang branch,
not yet on main. The bead asks for 'Read the full plain-language
explainer →' links from learn.html's M04/M07/M14 sections — that
linking is a follow-up patch once cp-0on lands on main, alongside
the identical follow-up already tracked for cp-j0gw.15.

Test plan

  • npm test — 239/239 vitest pass (was 218 + 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 new page in a browser to verify breadcrumb,
    disclaimer rendering, callout link, and sources.html deep links

Three additional narrative-paced standalone explainers extending the
cp-j0gw.15 set, sized between the /learn/ panels and the M-doc source:

- web/explainers/M04.html — pass/fail trigger + two-failures-in-three-
  years rule + four-year earnings lag
- web/explainers/M07.html — first-failure disclosures under proposed
  § 668.43(d)(1); 2023 GE-rule procedural model; appeal/disclosure
  interaction
- web/explainers/M14.html — named CIP families (50.05, 50.07, 50.09,
  51.15) per the Department's regulatory-impact analysis; recomputed
  elevation factors; structural-disparate-impact framing

Each page mirrors the shared cp-j0gw.15 patterns (public-data-badge,
top-disclaimer, breadcrumb, verify-callout linking to /sources.html,
explainer-nav between siblings) and renders standalone via the
existing web/css/explainers.css.

Extends tests/ui/explainers.test.ts PAGES array with the 3 new entries
(7 structural assertions per page = 21 new tests).

Branch base note: branched from origin/cp-j0gw.15-plain-lang-explainers
(itself off main) so the test-file extension works against the existing
PAGES array. Per the bead's directive 'NOT cp-0on-ext-senate-plain-lang',
this branch carries no senate-packet content.

learn.html linking note: learn.html is in the in-flight cp-0on branch,
not yet on main. The bead asks for 'Read the full plain-language
explainer →' links from M04/M07/M14 sections of learn.html — that
linking is a follow-up patch once cp-0on lands on main, alongside the
identical follow-up tracked for cp-j0gw.15.

239/239 vitest pass (was 218 + 21 new). Typecheck clean.
Glossary linter clean across content/ and web/.
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