Update anchor titles and text for accessibility #13678
Merged
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Description
I think the use of the title attribute on links has been overused/abused in the docs, and the text content of many links could be improved as well.
Generally, I don't think the title attribute should be used, and there's a lot of material out there about why we should avoid using it:
I found many where the title value would be better if used as the anchor text, or the title was duplicating the anchor text or anchor URL. I don't think having the tooltip on hover containing the same text that's already visible or is a full URL is useful. Additionally, screen readers don't always read aloud the title attribute, and when they do, it's usually in addition to the link text. This means that a screen reader might read a huge URL twice when it's used as both the link's text and title!
I'm not sure if maybe I was a bit heavy-handed or maybe light-handed in some areas, but I think this is an improvement overall.
I tried to avoid making significant changes to verbiage.
I left some titles where I thought it wasn't too critical if it weren't read, and not so disruptive if it were read.
I also left some links where the text was the link URL when the URL itself might be important (e.g. localhost URLs) or if it was really short.
Related Issues