<troubleshooting>
The <troubleshooting>
element is the top-level element for a
troubleshooting
topic.
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.