Note 04 · Navigation
Write links that name their destination
A link is a small promise about what comes next. Clear labels help readers decide whether to follow it and recognise where they have arrived.
Use a specific label
Name the article, action or resource instead of writing click here. In a sentence about image descriptions, a link labelled writing useful image descriptions remains understandable when read separately. Keep the visible label close to the destination title so the next page feels like a continuation of the same task.
Preserve ordinary browser behaviour
Use a normal anchor with a real address. Readers can then open another tab, copy the location or use keyboard navigation. Avoid making a decorative card the only route to an article. A visible text link is enough, and its focus state should remain easy to see.
Check both ends
Follow links from the published tree and check the destination heading. A file existing on disk does not prove that the public URL works. Check trailing slashes and any section fragments as well. When a page moves, decide whether to preserve its old route rather than leaving a familiar link to fail silently.