Vague link text: what it means and how to fix it

What we look for

These pages have links to other pages on the site whose whole text is a generic phrase, such as 'read more', 'learn more', 'here' or 'more'.

Why it matters

Generic words tell searchers and search engines nothing about the page a link leads to, and people using screen readers, who often scan a list of links, hear the same phrase again and again.

How to fix

Rewrite each link's text in the CMS or page template to name where it leads, for example 'Read our pricing guide' instead of 'read more'.

Where you’ll see it

The id is stable, and every surface uses it, so it’s the thing to search for or hand to an agent.

Terminal: When it is one of the five findings under Fix first, raptor crawl prints the id under it.
Check: links.non_descriptive_anchor
crawl.json and the CSV: The crawl JSON names the finding by this id, and so do the CSV and raptor_query.
"check_id": "links.non_descriptive_anchor"
The HTML report: This link opens the finding in the report, and each finding shows its id.
crawl.html#finding=links.non_descriptive_anchor
MCP: raptor_findings with this check_id returns the finding in full, with a fix brief ready to paste into a task. If it didn’t fire, it says why.
raptor_findings { "job_id": "...", "check_id": "links.non_descriptive_anchor" }