Skip to content
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

Need links to Understanding docs for guidelines #595

Open
mmeller75 opened this issue Jan 28, 2019 · 9 comments
Open

Need links to Understanding docs for guidelines #595

mmeller75 opened this issue Jan 28, 2019 · 9 comments
Assignees
Labels
Editorial Errata Erratum to a Recommendation

Comments

@mmeller75
Copy link

Links are needed to the Understanding documents for the guidelines from WCAG 2.1.

Currently, it takes several steps to find those Understanding docs. For example, reaching "Understanding Guideline 1.1: Text Alternatives" requires selecting the link "Understanding Non-text Content" under Success Criterion 1.1.1 Non-text Content, then choosing "GL: Text Alternatives" from the navigation at the top of the page.

@patrickhlauke
Copy link
Member

Not quite sure from where you mean links are needed.

If, for instance, you're on https://www.w3.org/TR/WCAG21/#text-alternatives, there are links in the boxout right there to the understanding and "how to meet" documents, pointing directly to the correct place.

Screenshot of WCAG 2.1 SC 1.1.1 showing the boxout with links to understanding and how-to-meet

@patrickhlauke
Copy link
Member

and there's a link to the main entry point for the understanding doc in the front matter section of the WCAG https://www.w3.org/TR/WCAG21/#wcag-2-1-supporting-documents

@mmeller75
Copy link
Author

Yes, there is one to SC 1.1.1, but if you look above at the guideline, 1.1, there is no link to the understanding document.

screen shot 2019-01-28 at 2 53 32 pm

@patrickhlauke
Copy link
Member

ah, now I get you. sorry, misread and thought you meant individual SCs. so yes, having some link from the guideline itself to https://www.w3.org/WAI/WCAG21/Understanding/text-alternatives ... makes sense

@mmeller75
Copy link
Author

Those may not be used as much, and it is possible to get to them, but it takes a little work. I noticed in particular when I was looking for GL 1.2. A link right below the permalink, like with the SCs, would be very helpful.

@awkawk
Copy link
Member

awkawk commented Jan 28, 2019

Unfortunately these are in the Recommendation so we may not be able to fix immediately. I assigned Michael to this as he will handle this in the generator.

@michael-n-cooper michael-n-cooper added Editorial ErratumRaised Potential erratum for a Recommendation labels Jan 29, 2019
@michael-n-cooper
Copy link
Member

We can fix this when we do the Edited Recommendation, which will probably be soonish.

@awkawk
Copy link
Member

awkawk commented Feb 12, 2019

Approved in survey and on call: https://www.w3.org/2019/02/12-ag-minutes.html#item03

@awkawk awkawk added Errata Erratum to a Recommendation and removed ErratumRaised Potential erratum for a Recommendation labels Feb 12, 2019
@awkawk
Copy link
Member

awkawk commented Feb 21, 2019

Approved as errata in CfC Feb 21 2019. Leaving open for Michael to implement.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Editorial Errata Erratum to a Recommendation
Projects
None yet
Development

No branches or pull requests

4 participants