Why
- A link is seen before the text around it. It’s a different color and underlined, so the scanning eye stops on it. At that moment “read more” doesn’t say more about what.
- A list of links. A screen reader can list all the links on a page; ten “here”s in it are indistinguishable. WCAG 2.4.4 (AA) requires a link’s purpose to be clear from its text or the sentence around it.
- Searching the page.
Ctrl+Ffor “Traefik” finds the link “Traefik labels” but not “this”.
What it looks like
| Empty | Says where it leads |
|---|---|
| For label setup, see [here]. | Details are in [Traefik labels]. |
| [Read more] | [How material sets work] |
| You can download it [via this link]. | [Download the extension archive, .zip] |
| [Continue reading…] | [Restoring the database in 4 steps] |
On this site, links to pages are written as [[slug]], and the build uses the page’s short name as the link text:
“details — Traefik labels”. Empty links can’t happen by design.
A URL as link text
A bare URL like https://example.org/docs/v3/routing/overview works when the address itself is the information: people
will copy it, dictate it or compare it. Otherwise, use the page’s title as the text.