<draft-comment> in troubleshooting topics

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)