Link text should include meaningful context

[pcraig3]

Hi @YedidaZalik,

Going through the app, I noticed a number of links that we should improve for screenreaders.

Screenreader users often skip from link to link, and Voiceover for Mac also can show a list of all links on the page. This means that someone reading a link won't necessarily see the sentence it's a part of.

This Webaim article on screenreader best practices is pretty good (and short).

Basically, the link should be enough context on its own that someone who clicks on it will know where they are going.

I've noticed that we could improve this in a few places:

• the offramp pages
• the confirmation page
• the "rent receipts" link: http://www.sjto.gov.on.ca/ltb/faqs/#faq3 (if read on its own, it's not descriptive of what it is)

For example, for this text (on the eligibility offramp page for too-high incomes)

A screenreader will see this:

current	better
"Learn"	"Learn if you can use a tax clinic"
"NETFILE"	(This one is okay because the linked page is about Netfile)
"Learn"	"Learn which certified NETFILE software is free"
"check"	"check if you are eligible"

Usually, you just want the link text to be a phrase that's meaningful.

Other things we can do include

• add additional hidden text that is only visible to screenreaders
  • we do this on the confirmation page for the "Learn more" links
• overwrite the link text entirely by putting in another message for screenreaders to read