A draft comment is content that is intended for review and discussion, such as questions, comments, and notes to reviewers. This content is not intended to be included in production output.

Rendering expectations

By default, processors SHOULD NOT render <draft-comment> elements. Processors SHOULD provide a mechanism that causes the content of the <draft-comment> element to be rendered in draft output only.

Content model

(Text | <audio> | <dl> | <div> | <imagemap> | <example> | <fig> | <image> | <lines> | <lq> | <note> | <hazardstatement> | <object> | <ol> | <p> | <pre> | <simpletable> | <sl> | <table> | <ul> | <video> | <cite> | <include> | <keyword> | <ph> | <strong> | <em> | <b> | <i> | <line-through> | <overline> | <sup> | <sub> | <tt> | <u> | <q> | <term> | <text> | <tm> | <xref> | <state> | <data> | <sort-as> | <foreign> | <unknown> )*


The following attributes are available on this element: universal attributes and the attributes defined below.

Designates the originator of the draft comment.
Specifies the status of the draft comment.
Specifies when the draft comment was created.

For this element, the @translate attribute has a default value of no.


The following code samples shows how a content developer can use a <draft-comment> element to pose a question to reviewers. Note that the @author and @time attributes are used to provide information who created the draft comment and when it was created.

<draft-comment author="EBP" time="23 May 2017">
  <p>Where's the usage information for this section?</p>

Processors might render the information from the highlighted attributes at viewing or publishing time. Authors might use the value of the @disposition attribute to track the work that remains to be done on a content collection.