Skip to content

consistent-navigation-ACT-Rule-proposal #2050

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

Draft
wants to merge 14 commits into
base: develop
Choose a base branch
from

Conversation

ChrisLoiselle
Copy link
Collaborator

@ChrisLoiselle ChrisLoiselle commented Apr 17, 2023

Consistent Navigation manual test rule proposal

Adding manual test for consistent navigation within ACT rule structure and formatting.

Consistent Navigation manual test rule proposal
@Jym77
Copy link
Collaborator

Jym77 commented Apr 27, 2023

I've updated the frontmatter with id, mappings, …

Jym77
Jym77 previously requested changes Apr 27, 2023
@ChrisLoiselle
Copy link
Collaborator Author

@Jym77 on the topic of test subject, I defer to how we write rules and your knowledge of ACT vs. how we read WCAG's SC for understanding. I'm not clear as to changing the rule to interpret the SC other than how it is written. If you feel that we need to remove the ambiguous phrasing to make the rule more concrete and testable, then I support your recommendation. I don't want to change the SC based on the rule is where I'm coming from on the perspective of pulling from the SC on the testable content.

@ChrisLoiselle
Copy link
Collaborator Author

@Jym77 I'll give all of this some more thought and we can revisit soon. I should have more bandwidth next week. Thanks for all your feedback and the threaded discussion points!

@Jym77
Copy link
Collaborator

Jym77 commented Apr 27, 2023

@Jym77 on the topic of test subject, I defer to how we write rules and your knowledge of ACT vs. how we read WCAG's SC for understanding. I'm not clear as to changing the rule to interpret the SC other than how it is written. If you feel that we need to remove the ambiguous phrasing to make the rule more concrete and testable, then I support your recommendation. I don't want to change the SC based on the rule is where I'm coming from on the perspective of pulling from the SC on the testable content.

Yes, we cannot change the SC, but we can precise some of its terms.
Being unbambiguous is a requirement of our own rules format:

Applicability must be described objectively, unambiguously and in plain language.

I remember when we wrote the rule for Bypass block that we discussed about what makes a set of pages we should look for repeated content. In the end, we used the pages at "distance 1 " (1 link away) from the page under test (definition of block of repeated content).

This could also be a possibility here. That is, a page passes the rule if its "navigational mechanisms" are in the "same relative order" as they are in pages at distance 1. That would keep the focus (and the test subject) on a single page.

I was suggesting to have a (given) set of pages as a test subject. While I'm fairly convinced that could work on the conceptual level, this is something we haven't done, and rules don't really have way to say what is their test subject. So that might actually not really work in practice…


Also, remember that rules tend to only test part of a SC (because testing all of it in an unambiguous rule can be very tricky). So, it is perfectly fine to write a rule with the following properties:

  • when the rule fails, it is 100% guaranteed that the SC is not satisfied.
  • when the rule pass, there is still a possibility for the SC to be not satisfied.

this often gives us way to work around ambiguities by putting them in the untested bits. For example, if we list "navigational mechanism" as being breadcrumb and site navigation, then we are sure that swapping these breaks 3.2.3. We haven't solved the question of search form (or other), and we're not taking position on whether swapping the search field with the breadcrumb is OK or not. But we still have a valuable rule that detects some problems.

Similarly, if we end up with a definition of "set of web pages" which is too restrictive, this is also OK. As long as we can guarantee that a problem within our "set of web pages" is a WCAG failure, we're good; even if our "set of web pages" is too restrictive and it being OK doesn't guarantee that 3.2.3 is satisfied. Of course, we want our definition to be as close as possible as WCAG's intention, in order to have as much value as possible. But our main concern is first and foremost to have unambiguous rules.

@WilcoFiers WilcoFiers marked this pull request as draft July 20, 2023 13:53
@HelenBurge HelenBurge dismissed Jym77’s stale review February 7, 2025 13:50

Because I am editing it all

@HelenBurge HelenBurge requested a review from Jym77 February 7, 2025 13:51
@HelenBurge HelenBurge removed their request for review February 7, 2025 13:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
ACT TF request Discussion manual rule Rule Use this label for a new rule that does not exist already
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants