Table of Contents

Syntax #


Purpose #

The s.choice.head.option annotation is used to tag a span element as being a header to an action that a user can choose to perform during a procedure. This element can be contained within a choice table or plain text. A choice head option element can be paired with a choice head description element, but this is not required.

See s.choice.head.description for more information.

Examples #

The following is an example of a time when you might want to use the s.choice.head.option annotation:

In this example, the s.choice.head.option annotation will be applied to the span “Options”.

The following is an example of a rule that will apply s.choice.head.option:

The following is an example of the DITA output you would get from this annotation.


The following is the DITA XML output for the previous rule, with the relevant portion in bold:



<p><choptionhd id=”ID-0000008c”>Options</choptionhd> <chdeschd id=”ID-0000008e”>Explanations</chdeschd>


<p><choption id=”ID-00000090″>Option A</choption> <chdesc id=”ID-00000092″>This is what happens when you do Option A.</chdesc>


<p><choption id=”ID-00000094″>Option B</choption> <chdesc id=”ID-00000096″>This is what happens when you do Option B.</chdesc>