An open source design system that's fully customizable and agent ready
TypeScript
Correct WCAG AA target-size guidance (#5874)
rubyycheungb7198293739b
diff --git a/.github/instructions/docsite.instructions.md b/.github/instructions/docsite.instructions.mdindex 20789bfe2d..22fa6f2dfa 100644--- a/.github/instructions/docsite.instructions.md+++ b/.github/instructions/docsite.instructions.md@@ -98,9 +98,14 @@ for how it degrades on mobile, and flag the common failure modes:must be allowed to shrink (the classic fix for a child refusing to shrinkinside a flex row). Flag fixed widths on content that needs to fit narrowscreens.-- **Overflow & tap targets.** Wide content (tables, code blocks, long rows)- should scroll within its container, not blow out the page width. Interactive- targets should stay comfortably tappable (~44px) at mobile sizes.+- **Overflow & target sizes.** Wide content (tables, code blocks, long rows)+ should scroll within its container, not blow out the page width. WCAG 2.2+ [criterion 2.5.8](https://www.w3.org/WAI/WCAG22/Understanding/target-size-minimum.html)+ (Level AA) requires targets to be at least 24×24 CSS px, or to satisfy its+ spacing or other exceptions. The 44×44 CSS px threshold belongs to enhanced+ [criterion 2.5.5](https://www.w3.org/WAI/WCAG22/Understanding/target-size-enhanced.html)+ (Level AAA). Do not substitute the AAA threshold when evaluating or reporting+ AA conformance.- **Prefer CSS-first responsiveness.** The docsite leans on `useMediaQuery` /`isMobile` JS in places; for _layout_ that CSS can express, prefer`@container` queries, `Grid` `minChildWidth`, `flex-wrap`, and