`<cause>`

The <cause> element describes a potential source of the problem that is addressed by the troubleshooting topic.

Usage information

The <cause> element is a component of a potential solution. The cause might be omitted if it is implicit or if the remedy is not associated with a cause.

Specialization hierarchy

The <cause> element is specialized from <section>. It is defined in the troubleshooting module.

Attributes

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

Example

This section is non-normative.

In the following code sample, the <cause> element contains information that explains the origins of the problem:

<troubleshooting id="simple-example">
  <title>System will not turn on</title>
  <troublebody>
    <condition>The system is plugged in and powered up, but the system will not start.
    </condition>
    <troubleSolution>
      <!-- . . . -->
      <cause>The problem is usually due to the power not being supplied to the system through
             the electrical outlet. Often, a circuit breaker has been tripped so that no
             power is available at the outlet.</p>
      </cause>
      <!-- . . . -->
    </troubleSolution>
    <!-- . . . -->
  </troublebody>
</troubleshooting>