Skip to content
GitHub
Sections

Reference · UI writing

Generic link text

Forbidden
"Learn more", "Read more", "Click here" — especially three "Learn more" links in a row
Instead
Name the destination: "Explore templates", "How affiliates work", "Email marketing features".

What this rule looks like

Forbidden
Instead

Why this rule

Screen reader users pull up a list of every link on a page; a list of "learn more" is useless. Sighted users scanning have to read the surrounding text to work out where each one goes. Three identical links also imply one destination. "Click here" is worse still: it explains a mechanism people already understand, and it is wrong for anyone on touch, keyboard or voice. Often the cleanest fix is to drop the link and make the heading the link. Buttons too. "Get started", "Learn more", "Try it free" on every call to action say that something happens, not what. Name the outcome: "Create a workspace", "Search your first log file", "Book a 20-minute demo". A button whose label would fit any product is a button the reader has to decode.

Kind
Rule
Section
UI writing
Group
Labels and links
Bucket
judgment
Severity
note
Since
v0.1.0

Read as plain text