No "here" in link text

This rule checks for the use of the word "here" as the text content of hyperlinks. It helps enforce better accessibility and clearer content navigation by preventing vague, non-descriptive link text.

Using "here" as link text (like "click here" or just "here") is considered poor practice because:

  • It provides no context about the link's destination when read out of context
  • It's not helpful for screen reader users who may navigate by scanning links
  • It fails to convey meaningful information about where the link will take users

Examples

Would flag ❌:

  • [here](https://example.com)
  • [Click here](https://example.com)
  • [HERE](https://example.com)

Would allow ✅:

  • [Download the report](https://example.com)
  • [View documentation](https://example.com)
  • [Learn more about our services](https://example.com)

Rule Source

This rule comes from: https://github.com/mesosphere/dcos-docs-site

Rule Definition

---
message: "Don't use '%s' as the content of a link."
extends: existence
ignorecase: true
scope: link
level: error
tokens:
  - here