The Crash Course to DocBook

6.7. Procedures

Procedure lists are a specialized orderedlist used for listing step-by-step procedures like you would find in a recipe or Linux HowTo.

Example 6-7. A procedure list


<procedure>
<title>Waking Up</title>
<para>This is what you must do to awaken.</para>
<step performance="required">
<para>
Bring yourself to a hypnopompic state, either from an ongoing dream or by use of
your internal clock. You may feel unable to move, but you will no longer be
dreaming. </para>
<para>Now you are ready for real-world readjustment.</para>
<substeps>
<step performance="optional">
<para>Roll over.</para>
</step>
<step performance="required">
<para>Squint out of one eye.</para>
</step>
</substeps>
</step>
<step performance="required">
<para>Yawn and rise from your bed.
</para>
</step>
</procedure> 

The above example would look something like this when converted:

Waking Up

This is what you must do to awaken.

  1. Bring yourself to a hypnopompic state, either from an ongoing dream or by use of your internal clock. You may feel unable to move, but you will no longer be dreaming.

    Now you are ready for real-world readjustment.

    1. Roll over.

    2. Squint out of one eye.

  2. Yawn and rise from your bed.