CodeYourFuture / CodeYourFuture/CYF-PD

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

Open
#43 0 comments 1 reaction 0 assignees View on GitHub
:gear: bug
Dominant language
HTML
Stars
1
Forks
5
PR merge metrics
No merged PRs in 30d

Description

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

Contributor guide

Open the contributing guide

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.