Denis Defreyne

A good hyperlink has enough context to work around broken URLs

Up: Technical writing

URLs serve only to locate resources, and don’t have intrinsic meaning. This can become a problem if a URL no longer leads to the expected resource (e.g. server returns 404 Not Found or 410 Gone).

URLs can “break” this way, but this does not mean the resource has vanished forever: it could have moved to a different URL, or there might be other copies of this resource elsewhere at different URLs.

A good (hyper)link provides context, to facilitate finding a replacement URL, in case the original URL no longer points to the expected resource. This context provides, at a minimum, the title and author of the resource.

To do: Figure out difference between context and link text (e.g. author doesn’t need to be part of link text).

Example

Denis Defreyne’s Using Lensesarticle provides a method of building complex forms with React (framework) and Type­Script.

The link text is the name of the resource, and the context provides the author name as well as keywords.

Perhaps in the example above, my full name (i.e. name of the author) could also be hyperlinked.

Open questions

Could a citation format be used instead? It would include the title of the article, the name of the author, and the publisher. Could that information be embedded into the a element?

Note last edited October 2026.
Incoming links: