Language reference : Technical content architecture : Task elements : substeps
The <substeps> element allows you to break a step down into a series of separate actions, and should be used only if necessary. Try to describe the steps of a task in a single level of steps. If you need to use more than one level of substep nesting, you should probably rewrite the task to simplify it.
Note: These models represent only the default document types distributed by OASIS. Actual content models will differ with each new document type.
Content model
ditabase, task, machineryTask, learningContent
(substep) (one or more)
Contained by
Content model
ditabase, task (strict), task (general), machineryTask, learningContent
- topic/ol task/substeps
Example 217. Example
<substep><cmd>Hold pencil in a steady, level position.</cmd></substep>
<substep><cmd>Turn handle until resistance diminishes.</cmd>
<info>Note: initially, it may be somewhat difficult to turn the handle if
pencil has never been sharpened before.</info></substep>
<substep><cmd>To determine if pencil is sharp, remove it from the sharpener
and inspect the tip.</cmd></substep>
Data Type
Default Value
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups)
A set of related attributes, described in univ-atts attribute group
global-atts attribute group (xtrf, xtrc)
A set of related attributes, described in global-atts attribute group
class, outputclass
Common attributes described in Other common DITA attributes