The general task document and information types are new to DITA 1.2. They provide a less strict content model for task-oriented information than was available in DITA 1.0 and 1.1. The general task content model may be preferred over the strict task model by some organizations. It can facilitate the migration of legacy content that does not follow the strict task topic model. The general task information type serves as the base for the strict task and machine-industry task document types, can be used to create new document types, and serves as a base for new structural specializations.
Like the DITA strict task document type, the general task document and information types contain the essential building blocks to provide procedural information. Both task information types answer the "How do I?" question by providing step-by-step instructions detailing the requirements that must be fulfilled, the actions that must be performed, and the order in which the actions must be performed. Both task topics include sections for describing the context, prerequisites, expected results, and other aspects of a task.
The general task information type is specifically designed to accommodate task specializations that differ from the DITA task information type. It may also be used for the conversion of loosely structured tasks from other sources into DITA before they are restructured to follow the more restrictive DITA task model.
The <task> element is the top-level element for the general task topic. The general task topic contains a title and a taskbody with optional alternative titles (titlealts), a short description or abstract, a prolog,and related-links.
The following elements are described here because they are introduced as part of the general task model. All other elements are described in the strict task topic.
The following table compares the structures of general and strict task:
| General taskbody | Strict taskbody constraint |
|---|---|
| prerequisite (optional, in any order, any number) | prerequisite (optional, one only, must precede context) |
| context (optional, in any order, any number) | context (optional, one only, must follow prerequisite) |
| section (optional, in any order, any number) | (not defined for strict taskbody) |
| steps | steps |
| steps-unordered | steps-unordered |
| steps-informal | (not defined for strict taskbody)) |
| result (optional, one only, precedes example) | result (optional, one only, precedes example) |
| example (optional, any number, precedes post-req) | example (optional, one only, precedes post-req) |
| post-requisite (optional, any number) | post-requisite (optional, one only) |
The following DITA modules are provided for the task topic.
Return to main page.
OASIS DITA Version 1.2 -- OASIS Standard, 1 December 2010
Copyright © OASIS Open 2005, 2010. All Rights Reserved.