Chapter 1. Topic-Based Writing in DITA

What’s a topic other than a conversational piece? In technical information, a topic, which is sometimes called an article, has a title and some content. A topic has just enough content to make sense by itself but not so much content that it covers more than one procedure, one concept, or one type of reference information.

Although a topic should be self-contained, it shouldn’t live alone. For information delivered with most technical products, services, or technologies, a topic needs a home in a larger, organized collection of topics. That collection can then be packaged and delivered in an output format such as HTML web pages, online help, or a PDF manual.

Darwin Information Typing Architecture (DITA) ...

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

O’Reilly members experience live online training, plus books, videos, and digital content from 200+ publishers.