Repository navigation
Commit 7ef50a4
docs(qa): add cross-cutting UX convention items to the platform checklist (#22140)
## Summary
On the maintainer's instruction — 「写进测试清单:把这些原则加到
docs/qa/platform-checklist/,例如"每个写操作都有反馈""每个禁用控件都说明原因""不对用户显示机器名"。这样以后每轮测试都会检查。」
— this adds one area,
`docs/qa/platform-checklist/areas/ux-conventions.json`, with three items
so every checklist run samples these conventions across the console and
Studio:
- `ux-conventions.write-feedback` — every user-initiated write answers
visibly: success names what changed, a refusal says why, a no-op claims
nothing, and Undo restores where a surface offers it.
- `ux-conventions.disabled-control-reason` — every disabled control
shows its reason on hover and on keyboard focus, and exposes it as an
accessible description.
- `ux-conventions.labels-over-machine-names` — where a label exists
users see it; machine names, raw ids and spec paths appear only as
secondary text.
Each item lists the rows known to fail on stock in `knownGaps`, citing
the objectui cards filed from the 2026-10-07 browser QA pass, so a run
scores them fail and cites the card instead of re-filing.
`FOLLOW-UPS.md` section 11 registers those rows (F1–F8) and three open
decisions for the maintainer: P1 vs P0 (whether these join every release
sweep), which writes should offer Undo, and whether direct manipulation
needs a toast. `scripts/checklist-symbol-anchor-baseline.json` gains a
floor for the new area file at the count `--anchor-census` measured (8)
— a new floor, no floor lowered.
Scope: a scoped authoring by one reader, grounded in a source reading on
`main` and the browser pass — not a five-angle sweep, so it makes no
claim about what else is missing.
## Verification
- `pnpm check:platform-checklist` — exit 0: selector self-test 31 cases,
validator self-test 221 assertions, ledger OK (16 areas, 279 items, 18
file floors held).
- `node scripts/checklist-select.mjs area:ux-conventions` — resolves the
three items as runnable.
- `node scripts/check-doc-authoring.mjs` — exit 0 (this required gate
reads `docs/qa/`).
## Changeset
A QA ledger and its anchor baseline only — nothing publishes from a
released package, so this PR carries `skip-changeset`.
---
_Generated by [Claude
Code](https://claude.ai/code/session_01D76mrPJrSSdaKRxR2rvrMG)_
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent 8f2e808 commit 7ef50a4
3 files changed
Lines changed: 339 additions & 1 deletion
File tree
- docs/qa/platform-checklist
- areas
- scripts
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
659 | 659 | | |
660 | 660 | | |
661 | 661 | | |
| 662 | + | |
| 663 | + | |
| 664 | + | |
| 665 | + | |
| 666 | + | |
| 667 | + | |
| 668 | + | |
| 669 | + | |
| 670 | + | |
| 671 | + | |
| 672 | + | |
| 673 | + | |
| 674 | + | |
| 675 | + | |
| 676 | + | |
| 677 | + | |
| 678 | + | |
| 679 | + | |
| 680 | + | |
| 681 | + | |
| 682 | + | |
| 683 | + | |
| 684 | + | |
| 685 | + | |
| 686 | + | |
| 687 | + | |
| 688 | + | |
| 689 | + | |
| 690 | + | |
| 691 | + | |
| 692 | + | |
| 693 | + | |
| 694 | + | |
| 695 | + | |
| 696 | + | |
| 697 | + | |
| 698 | + | |
| 699 | + | |
| 700 | + | |
| 701 | + | |
| 702 | + | |
| 703 | + | |
| 704 | + | |
| 705 | + | |
| 706 | + | |
| 707 | + | |
| 708 | + | |
| 709 | + | |
| 710 | + | |
| 711 | + | |
0 commit comments