basforge

Search titles, text and the “If it doesn’t work” cases.

    RU

    Link text says where it leads — no “here” or “read more”

    Link text is what will open: “Traefik labels”, “the October price table”, not “here”, “this” or “read more”. A link is an anchor the eye picks out of a paragraph first, and “here” tells it nothing at that moment.

    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+F for “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 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.