troubleshooting

Darwin Information Typing Architecture (DITA) Version 1.3 Part 2: Technical Content Edition

version
1.3
author
OASIS DITA Technical Committee

The troubleshooting element is the top-level element for a troubleshooting topic. Troubleshooting topics document corrective action such as troubleshooting or alarm clearing. Troubleshooting topics begin with a description of a condition that the reader might want to correct, followed by one or more cause-remedy pairs. Each cause-remedy pair is a potential solution to the trouble described in the condition.

Troubleshooting topics represent the kind of information that users typically consult to fix a problem.

Content models

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

Inheritance

- topic/topic troubleshooting/troubleshooting

Example

<troubleshooting id="resolve" xml:lang="en-us" >
  <title>E247 - Memory fault has occured</title>
  <shortdesc>The system has detected a problem in memory.
  </shortdesc>
  <troublebody>
    <condition>
      <p>The fault indicator flashes on the front panel, and
        the error log contains the following message:
        <msgph>E247 - Memory fault has occured</msgph></p>
    </condition>
    <troubleSolution>
      <cause>
        <p>Transient memory fault.</p>
      </cause>
      <remedy>
        <responsibleParty>System administrator
        </responsibleParty>
        <steps>
          <step>
            <cmd>Reset the alarm</cmd>
          </step>
          <step>
            <cmd>Monitor the system periodically to see whether
               the alarm recurs</cmd>
          </step>
        </steps>
      </remedy>
    </troubleSolution>
    <troubleSolution>
      <cause>
        <p>Recurring memory fault indicates possible problem
          with the system memory board. Reseating the board
          may fix the problem.</p>
      </cause>
      <remedy>
        <responsibleParty>Maintenance technician
        </responsibleParty>
        <steps
          conref="BoardReseat.dita#BoardReseatg/steps">
          <step>
            <cmd/>
          </step>
        </steps>
      </remedy>
    </troubleSolution>
    <troubleSolution>
      <cause>
        <p>Reseating the system memory board did not fix
          the problem. Replacing the board may fix the
          problem.</p>
      </cause>
      <remedy>
        <responsibleParty>Maintenance technician
        </responsibleParty>
        <steps
          conref="BoardReplace.dita#BoardReplac/steps">
          <step>
            <cmd/>
          </step>
        </steps>
      </remedy>
    </troubleSolution>
  </troublebody>
</troubleshooting>

Attributes

The following attributes are available on this element: Universal attribute group (with a narrowed definition of id, given below), Architectural attribute group, and outputclass.

id (REQUIRED)
An anchor point. This ID is usually required as part of the href or conref syntax when cross referencing or reusing content within the topic; it also enables topicref elements in DITA maps to optionally reference a specific topic within a DITA document. This attribute is defined with the XML Data Type ID.