remove must which is not normative

[jnurthen]

Musts in MDN are being misinterpreted as normative requirements. There is no MUST requirement here in the ARIA spec (it is a should) so MDN should not introduce one

Description

Change must always to should to match the ARIA spec

Motivation

Devs misinterpret MDN as normative requirements

Additional details

Related issues and pull requests

[github-actions]

Preview URLs

• /en-US/docs/Web/Accessibility/ARIA/Roles/alertdialog_role

Flaws (8)

URL: /en-US/docs/Web/Accessibility/ARIA/Roles/alertdialog_role
Title: ARIA: alertdialog role
Flaw count: 8

• macros:
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/Accessibility/
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/Accessibility/What_is_accessibility
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/Accessibility/HTML
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/Accessibility/CSS_and_JavaScript
  • Wrong xref macro used (consider changing which macro you use). Error processing path /en-US/docs/Learn/Accessibility/WAI-ARIA_basics
  • and 3 more flaws omitted

[devongovett]

There is another "must" further down the page:

The alert dialog text must have an accessible description using aria-describedby.

Whereas this is also SHOULD in the spec:

Authors SHOULD use aria-describedby on an alertdialog to reference the alert message element in the dialog.

[jnurthen]

There is another "must" further down the page:

The alert dialog text must have an accessible description using aria-describedby.

Whereas this is also SHOULD in the spec:

Authors SHOULD use aria-describedby on an alertdialog to reference the alert message element in the dialog.

There are far more than one more - probably all of them should be changed but I wanted to keep this as small as possible for now.

[estelle]

Thanks! 🎉