Darwin Information Typing Architecture (DITA) Version 1.3 Part 3: All-Inclusive Edition

OASIS DITA Technical Committee

The stepsection element provides expository text before a step element. Although the element is specialized from li and has the same content model as a list item, it is not intended to represent a step in a task.

Note: DITA applications which render stepsection elements among the step elements must provide a way to number the steps without numbering the stepsection elements (although this does not need to be the only or default presentation).

Content models

See appendix for information about this element in OASIS document type shells.


- topic/li task/stepsection


  <step><cmd>Get out a bowl</cmd></step>
  <stepsection>The next two steps are very important!</stepsection>
  <step><cmd>Put on safety gloves</cmd></step>
  <step><cmd>Put on goggles</cmd></step>
  <step><cmd>Pour milk and cereal into the bowl</cmd></step>

The sample above would typically be rendered with "Get out a bowl" as step number one, "Put on safety gloves" as step number two, and "The next two steps are very important!" as an unnumbered item in between the first two items.


The following attributes are available on this element: Universal attribute group and outputclass.