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.
Contains
Note: These models represent only the default document types distributed by OASIS.
Actual content models will differ with each new document type.
Doctype |
Content model |
ditabase, task, machineryTask, learningContent |
(substep) (one or more) |
Contained by
Doctype |
Content model |
ditabase, task (strict), task (general), machineryTask, learningContent |
step |
Inheritance
- topic/ol task/substeps
Example
<substeps>
<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>
</substeps>