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 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.