docs: add RD-37 — five a11y suppressions name a ticket that closed
Found while measuring RD-30, which archives the directory these references point into. Five stories disable the axe check with the reason "WP-11 reworks this markup". WP-11 is done, and so is WP-13, the gap register it handed the remainder to. No open ticket owns the defect, so the rule that a disabled check must name the ticket that removes it holds only in letter. The defect ships: `app-choice-link` and `app-aanvraag-block` put a component host between the keuzelijst `<ul>` and its `<li>`, which breaks axe's list/listitem rule. WP-11 solved the same problem for `application-link` by making the host be the `<li>`, but `atomic-design.mdx` documents the current split as deliberate — so whether that move fights the vendored CSS is the question RD-37 must answer first. Sequenced before RD-30. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
@@ -787,6 +787,34 @@ than ESLint: it is where every other boundary rule lives and it emits the archit
|
||||
|
||||
## Phase 5 — Fix the docs that describe this flow
|
||||
|
||||
0. **First, RD-37 — five accessibility suppressions point at a ticket that closed.** Found
|
||||
while measuring RD-30, because archiving `backlog/` would bury the reference.
|
||||
|
||||
Five stories carry `a11y: { disable: true }` whose reason reads "WP-11 (CIBG markup
|
||||
fidelity) reworks this markup" — future tense. **WP-11 is `Status: done`**, and so is
|
||||
WP-13, the gap register it hands the remainder to. No open ticket owns the defect, so the
|
||||
README's rule ("no check disabled without a reference to the ticket that removes it") holds
|
||||
only in letter.
|
||||
|
||||
The defect is real and shipped, not story-only: `app-choice-link` and `app-aanvraag-block`
|
||||
render a component host between the keuzelijst `<ul>` and its `<li>`, which breaks axe's
|
||||
`list`/`listitem` rule for assistive technology. `display: contents` does not fix it.
|
||||
|
||||
WP-11 solved exactly this for `application-link` by making the host **be** the `<li>`
|
||||
(`selector: 'li[app-application-link]'`), which is axe-clean today. The same move is
|
||||
available here — but it is **not** obviously correct, and that is why this is a ticket
|
||||
rather than a one-line change: `atomic-design.mdx:113` documents the current split as
|
||||
deliberate, "different list/host semantics … Merging would fight the vendored CSS".
|
||||
|
||||
So RD-37 must decide one question before it writes any code: **does giving `choice-link` and
|
||||
`aanvraag-block` an `li[…]` attribute host still match the vendored CIBG keuzelijst CSS?**
|
||||
If yes, convert both, delete the five suppressions, and correct `atomic-design.mdx`'s claim.
|
||||
If no, the honest outcome is a new open ticket named in five rewritten reasons — not a
|
||||
pointer into an archive.
|
||||
|
||||
**Sequence RD-37 before RD-30**, so the archive move does not have to rewrite five paths
|
||||
that are about to disappear.
|
||||
|
||||
1. **Archive the finished backlog.** `git mv docs/project/backlog` and
|
||||
`docs/project/refactor-backlog-setup` under `docs/project/archive/`. Verified: **all 74
|
||||
WP files are `Status: done`**; the two trees are 6,982 + 9,318 = **16,300 of the docs
|
||||
|
||||
Reference in New Issue
Block a user