`<tutorialinfo>`

Tutorial information is information that is useful when the task topic is rendered as a tutorial.

Specialization hierarchy

The <tutorialinfo> element is specialized from <div>. It is defined in the task module.

Content model

Contained by

<step>

Zero or more of the following

Text
<audio>
<cite>
<data>
<div>
<dl>
<draft-comment>
<example>
<fig>
<fn>
<foreign>
<image>
<include>
<indexterm>
<keyword>
<lines>
<lq>
<note>
<object>
<ol>
<p>
<ph>
<pre>
<q>
<required-cleanup>
<simpletable>
<sl>
<table>
<term>
<text>
<tm>
<ul>
<video>
<xref>

Contained by

<step>

Inheritance

- topic/div task/tutorialinfo

The <tutorialinfo> element is specialized from <div>. It is defined in the task module.

Attributes

The following attributes are available on this element: universal attributes.

Example

This section is non-normative.

The following code sample is of a task topic that is used both in a product manual and in a tutorial. Note that the <context> and <tutorialinfo> elements are intended to be rendered only when the tutorial is generated.

<task id="task-msg-x1z-gwb">
  <title>Taking pictures in low light without a flash</title>
  <shortdesc>Taking pictures in low light situations without a flash can be a challenge if you
      don’t know what you’re doing and can result in photos that are too dark, blurry, or 
      grainy. Follow these suggestions to get excellent shots in low light situations without 
      the need for your camera's flash.</shortdesc>
  <taskbody>
    <context deliveryTarget="tutorial">For example, suppose you are visiting the Louvre and 
        want to capture memories of your visit. Most museums do not allow flash photography
        of their art masterpieces.  What settings will work best for that situation? To 
        understand the best settings for such a situation before arriving, use this tutorial 
        to experiment with the impact of your light-controlling settings on your camera.
    </context>
    <steps>
      <step>
        <cmd>Put your camera in manual mode.</cmd>
      </step>
      <step>
        <cmd>Increase your ISO setting to adjust how sensitive your camera's image sensor is 
            to light.</cmd>
        <tutorialinfo deliveryTarget="tutorial">Take a picture at each of the following ISO 
               settings: 100, 200, 400, and 800. Compare your results.</tutorialinfo>
      </step>
      <step>
        <cmd>Increase the aperture size, by reducing your f-stop, to adjust how much light is 
            allowed in.</cmd>
        <tutorialinfo deliveryTarget="tutorial">Return your camera to an ISO setting of 100.
            Take a picture at each of the following f-stops: f/2.0, f/4, f/8, and f/16. 
            Compare your results.</tutorialinfo>
      </step>
      <!-- ... -->
    </steps>
  </taskbody>
</task>