Chapter 7. Linking

Well-written topics by themselves aren’t enough to help users accomplish their goals. Writing good topics is only the first step to creating useful technical information. The next step is to help users find that information and to help them get from one topic to another.

By implementing a well-designed linking strategy, you create an effective web of information and improve the retrievability and navigation of your content.

DITA has powerful linking features that you can use to create links:

Hierarchical links reveal the navigation of your information through nested topics.

Inline links connect users to related information; these links are inserted in the text of the topic.

Related links connect users to related information; ...

Get DITA Best Practices: A Roadmap for Writing, Editing, and Architecting in DITA now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.