-
Notifications
You must be signed in to change notification settings - Fork 257
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
Show technique titles, not just technique numbers, for related techniques #3583
Comments
Also in H69 (https://www.w3.org/WAI/WCAG22/Techniques/html/H69) are two related techniques where only the number is given. |
I suspect this is done for readability. Some techniques have very long names, and the list could become somewhat impenetrable, instead of easy to scan, as it is right now. However, I'll leave someone more familiar with conventions to comment on the current use. |
It may be readable, but it is unusable for me as just the number is meaningless. I wind up having to click each item to find out whether it is relevant to me. For cross-reference lists with more than three items, it becomes tedious. If long titles are problematic, then improved spacing between items or introducing a short title field would help. Actually, I believe just showing the technique number violates Success Criterion 2.4.4 Link Purpose (In Context), which is a level A criterion. |
I had thought that the names were automatically added as part of the build process, but it appears not. In any case, it would be a general task for someone to run through the technique and understanding documents and fill in the full titles.
No, there's an exception for when a link is ambigious to all users, which is the case here. That doesn't make it good, but not a fail of that SC. |
This has been resolved by the new Eleventy build system, which is currently used for 2.2 docs, and will be used to rebuild 2.1 docs once #4007 is merged. |
Technique PDF3:Ensuring correct tab and reading order in PDF documents has a section Related Techniques which provides links to related techniques. However, that section only gives the technique numbers without any context. It would be better to include the titles.
This appears to be an issue on related pages as well.
Current content:
Related Techniques
G57
G59
G202
Expected content:
G57: Ordering the content in a meaningful sequence
G59: Placing the interactive elements in an order that follows sequences and relationships within the content
G202: Ensuring keyboard control for all functionality
I seem to recall that techniques pages used to show the titles for related techniques, so this may be a regression.
The text was updated successfully, but these errors were encountered: