Skip to content

Concern for use of "must" in notes. #4432

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
bruce-usab opened this issue Jun 5, 2025 · 6 comments
Open

Concern for use of "must" in notes. #4432

bruce-usab opened this issue Jun 5, 2025 · 6 comments

Comments

@bruce-usab
Copy link
Contributor

In the WCAG2ICT call today, we discussed that use of "must" in a note is problematic.

Note: Since any content that does not meet this success criterion can interfere with a user's ability to use the whole page, all content on the web page (whether it is used to meet other success criteria or not) must meet this success criterion. See Conformance Requirement 5: Non-Interference.

Suggestion on call is to replace "must" with "would be necessary" or similar.

@patrickhlauke
Copy link
Member

While I understand the desire not to have MUST/SHOULD in non-normative prose, as that would introduce new normative requirements by the backdoor, I think in this case this is used as a way to signpost an already existing normative requirement coming from that conformance requirement 5?

@maryjom
Copy link
Contributor

maryjom commented Jun 5, 2025

The EN 301 549 is not allowed to have normative words in non-normative statements, and I thought that W3C standards were the same (not sure, but it would make sense). The WCAG2ICT TF discussed today - "would need to" might be sufficiently imperative without saying "must".

@bruce-usab
Copy link
Contributor Author

bruce-usab commented Jun 5, 2025

I agree that this is problematic for WCAG2ICT but merely editorial for WCAG 2.

Yes, the WCAG 2 citation to the conformance requirements supports the use of "must". WCAG2ICT has comments on conformance but that's different.

WCAG2ICT also has a grammar issue in that the word substitution differs between the criterion text and the note.

I could not make a simple word substitution for "must" work. How about:

Note: Since any content that does not meet this success criterion can interfere with a user's ability to use the whole page, it is necessary that all content on the web page (whether it is used to meet other success criteria or not) meet this success criterion.

@maryjom
Copy link
Contributor

maryjom commented Jun 5, 2025

Similar to a couple of proposals for this note in the WCAG2ICT issue 680, here's a couple more variations of @bruce-usab's suggestion above with verbiage changes bolded to help with reviewing in the context of this issue. It wouldn't be bolded when incorporated into WCAG.

Note: Since any content that does not meet this success criterion can interfere with a user's ability to use the whole page, it would be necessary for all content on the web page (whether it is used to meet other success criteria or not) to meet this success criterion. See Conformance Requirement 5: Non-Interference.

OR

Note: Since any content that does not meet this success criterion can interfere with a user's ability to use the whole page, all content on the web page (whether or not it is used to meet other success criteria) would need to meet this success criterion. See Conformance Requirement 5: Non-Interference.

@mbgower
Copy link
Contributor

mbgower commented Jun 5, 2025

Draft Official Working Group response
The WCAG note appearing in 1.4.2., 2.1.2, 2.1.2, and 2.3.1 that contains this "must" wording refers directly to 5.2.5 which states (in normative text):

If technologies are used in a way that is not accessibility supported, or if they are used in a non-conforming way, then they do not block the ability of users to access the rest of the page. In addition, the web page as a whole continues to meet the conformance requirements under each of the following conditions:

  1. when any technology that is not relied upon is turned on in a user agent,
  2. when any technology that is not relied upon is turned off in a user agent, and
    when any technology that is not relied upon is not supported by a user agent
  3. In addition, the following success criteria apply to all content on the page, including content that is not otherwise relied upon to meet conformance, because failure to meet them could interfere with any use of the page:
  • 1.4.2 - Audio Control,
  • 2.1.2 - No Keyboard Trap,
  • 2.3.1 - Three Flashes or Below Threshold, and
  • 2.2.2 - Pause, Stop, Hide.

So the use of "must" is appropriate in this case; it is not adding a new requirement in a note, but restating an existing requirement. The Working Group does not believe a change to the note is warranted in this case.

The WCAG2ICT Task Force is welcome to reword this note in their own TF guidance to provide a similar message without using the word "must".

@w3c w3c deleted a comment from Dfghj887533 Jun 6, 2025
@bruce-usab
Copy link
Contributor Author

Discussed on backlog call 6/6 and TF concurrence not to make a change. We might revisit after WCAG2ICT and EN 301 549.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

4 participants