CodeYourFuture/CYF-PD

Content bug: Use of [here] and [link] is not accessible

Opened this issue · 0 comments

I have seen this again on https://github.com/CodeYourFuture/CYF-PD/blob/main/content/blocks/create-groups-for-react/readme.md

Please stop writing links as [link] or [here] or [click here]

I give this feedback fairly regularly. Links must make sense out of context. If someone is accessing your content with a screenreader or other linearised access device, they may be accessing a linkslist. When you use text like "here" and "link" what happens is the linkslist just reads out like this:

link, link, here, link, click here 🤦‍♀️

It also breaks tabbing through links. If someone is trying to tab to a specific link, and cannot see where they are in the text, they can't locate themselves in the text as the link text is so completely devoid of information.

Please stop doing this. Thanks! 🙇‍♀️

https://webaim.org/techniques/hypertext/#screen_readers
https://www.w3.org/WAI/WCAG21/Understanding/link-purpose-in-context.html