<draft-comment> in troubleshooting topics

[Kristen James Eberlein <kris@eberleinconsulting.com>]

I've been working with a lot of troubleshooting topics lately, so I thought I'd close the loop on this action item.

For the most part, I think there are adequate places in the troubleshooting topic for <draft-comment> elements:

• Available in <abstract>, to apply to the topic as a whole
• Available in <condition>
• Available in <cause>

The exception is <remedy>. The content model of remedy as follows; we might want to consider allowing an optional <draft-comment> within <remedy>

DTD

<!ENTITY % remedy.content
ÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂ "((%title;)?,
ÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂ (%responsibleParty;)?,
ÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂ (%steps; |
ÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂ %steps-unordered; |
ÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂÂ %steps-informal;))"
>

RNG

ÂÂÂÂÂ <a:documentation> LONG NAME: Remedy </a:documentation>
ÂÂÂÂÂ <define name="remedy.content">
ÂÂÂÂÂÂÂ <optional>
ÂÂÂÂÂÂÂÂÂ <ref name="title"/>
ÂÂÂÂÂÂÂ </optional>
ÂÂÂÂÂÂÂ <optional>
ÂÂÂÂÂÂÂÂÂ <ref name="responsibleParty"/>
ÂÂÂÂÂÂÂ </optional>
ÂÂÂÂÂÂÂ <choice>
ÂÂÂÂÂÂÂÂÂ <ref name="steps"/>
ÂÂÂÂÂÂÂÂÂ <ref name="steps-unordered"/>
ÂÂÂÂÂÂÂÂÂ <ref name="steps-informal"/>
ÂÂÂÂÂÂÂ </choice>
ÂÂÂÂÂ </define>

--
Best,
Kris

Kristen James Eberlein
Chair, OASIS DITA Technical Committee
Principal consultant, Eberlein Consulting
www.eberleinconsulting.com
+1 919 622-1501; kriseberlein (skype)