liveBook · Manning

Hypertext link

As explained in Writing for Developers: Blogs that get read

A link embedded in digital content that allows a reader to navigate to another resource or location.

A hypertext link lets readers move from digital content to another resource or location. Make its text describe the destination, so readers can judge whether to follow it—even when accessing links out of context with a screen reader. section 7.4.5

Use this practical link checklist:

  • Replace vague text such as “here” or “read more” with the name or subject of the linked resource. section 7.4.5
  • Write links that remain understandable when readers scan a list of links without surrounding context. section 7.4.5
  • Open every link in the rendered HTML and confirm that it reaches the expected page; copied errors and moved documentation can create dead ends. section 7.4.5 section 7.6
  • Link only to details that help the target reader, avoiding hyperlink overload that distracts from the article. section 5.4.2

Name the resource

Prefer “Ultimately, we implemented that encryption layer by linking to RustyEncryption” over a sentence that makes “here” or the raw URL the link. section 7.4.5

How Writing for Developers: Blogs that get read covers it

How deep it goes
Explains link-text selection, accessibility, search clues, overload, and manual destination checks, stopping short of hyperlink implementation internals.
Examples
Uses “here,” raw URLs, RustyEncryption, moved documentation pages, and dead-end links as contrasting examples.
What you can do after
Apply it by writing descriptive link text, limiting unnecessary links, and verifying destinations in rendered HTML.
How it connects
Connects descriptive link text with accessibility, screen readers, search engines, metadata, and target-audience design.

Also explained in

Compare how 9 books explain hypertext link →

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Writing for Developers: Blogs that get read. The section links point to the parts of the book it draws on.