Public: anyone can read this; the crew can change it.

The first-login jargon test covers the menu and command palette labels, and what it finds is reworded #10782

Closed opened this
opened this

Intent: a zero-technical client meets no jargon anywhere on the first-login page, not only inside <main>. Replaces #10769, which was started twice before its base existed; this waits for #10752 to land.

Start from main once #10752 is merged: it adds the first-login jargon test and the word list (test/helpers/jargon.ts or wherever it lands; read the merged pull).

  • [ ] The test reads the whole first-login page for every role that lands there: visible text plus every aria-label, title and placeholder, including the site menu and the command palette.
  • [ ] Each hit it finds is reworded in plain words at its source (menu and palette label definitions), for that page or everywhere if the label is shared.
  • [ ] The test fails if a jargon word is put back into any of those labels (prove it by naming the one you tried in the pull).
  • [ ] bun scripts/design-lint.ts passes; before/after screenshot of the menu and palette open.

Files: the first-login jargon test from #10752, the menu and palette label sources under src/web. Risk: shared labels change on other pages too; that is intended, say which in the pull. Brief: mason or scout.

commented

replaced by #10791: the same work, with nothing in front of it now that #10752's test is on main (b239aee41).

Sign in to join this conversation.

↑↓ navigate ↵ open ⌘↵ its app esc close

Keyboard shortcuts

Docs