3.10 Technical content elements
Elements in the technical content section include the original Concept, Task, and
Reference specializations, as well as specializations added
. It also includes domains designed primarily for technical content.
3.10.1 Concept elements
DITA concept topics answer "What is..." questions. Use the concept topic to introduce the background or overview information for tasks or reference topics. The concept topic restricts content following a section or example to other sections or examples. For more details on when to use concept and other information types, please refer to the DITA architectural specification.
3.10.2 Task elements
Task topics answer "How do I?" questions, and have a well-defined structure that describes how to complete a procedure to accomplish a specific goal. Use the task topic to describe the steps of a particular task, or to provide an overview of a higher-level task. The task topic includes sections for describing the context, prerequisites, actual steps, expected results, example, and expected next steps for a task. For more details on when to use task and other information types, please refer to the DITA architectural specification.
3.10.3 Reference elements
Reference topics describe factual material about a subject, such as the commands in a programming language. This format is also suitable for bibliographies, catalogues, the list of ingredients for recipes, and similar collections of structured descriptive prose. For more details on when to use reference and other information types, please refer to the DITA architectural specification.
3.10.4 Troubleshooting elements
Troubleshooting topics document corrective action such as troubleshooting or alarm clearing.
3.10.5 Glossary elements
Glossary elements include those elements designed to specify terms and their definitions, as well as elements that are designed to group, reference, or otherwise make use of information in the glossentry topic.
3.10.6 Bookmap elements
Elements in the bookmap section are used to organize DITA content into book form. They include elements for dividing up content, such as chapter and appendix, as well as metadata specific to publishing.
3.10.7 Technical-content domains elements
Domains in this section include those generally associated with technical content, such as the programming and software domains.