Docs idea: add an applied modal screen-reader failure exercise

[MuslumYilmaz]

Context

The current Modal page has a concise Accessibility section covering the WAI-ARIA Dialog pattern, focus trapping, keyboard behavior, screen-reader attributes, and scroll locking. An optional failure-oriented exercise could help readers turn that checklist into manual keyboard and screen-reader verification.

Suggested resource

Modal opens visually but fails screen-reader users

The public guided incident covers escaped background focus, missing dialog semantics and accessible naming, keyboard behavior, focus restoration, and regression checks.

Would this kind of third-party exercise fit after the existing Accessibility checklist or as a further-learning link? If it is in scope, I can prepare a focused v3 documentation PR after maintainers confirm the right source file and contribution path. I will not open a PR unless that scope is confirmed.

Disclosure

I created and maintain FrontendAtlas and am affiliated with the linked resource. The incident is publicly accessible without signing in; the broader platform includes optional paid features. No paid, affiliate, reciprocal, or special link treatment is requested. If external educational links are outside the documentation scope, no change is needed.

I searched this repository's discussions for “FrontendAtlas” and for modal/accessibility-resource terms and found no matching discussion.

Target page: https://heroui.com/en/docs/react/components/modal