<draft-comment>
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>
|
<data>
|
<sort-as>
|
<foreign>
)*
- Text
-
<audio> -
<b> -
<cite> -
<data> -
<div> -
<dl> -
<em> -
<example> -
<fig> -
<foreign> -
<hazardstatement> -
<i> -
<image> -
<imagemap> -
<include> -
<keyword> -
<line-through> -
<lines> -
<lq> -
<note> -
<object> -
<ol> -
<overline> -
<p> -
<ph> -
<pre> -
<q> -
<simpletable> -
<sl> -
<sort-as> -
<strong> -
<sub> -
<sup> -
<table> -
<term> -
<text> -
<tm> -
<tt> -
<u> -
<ul> -
<video> -
<xref>
Attributes
The following attributes are available on this element: universal attributes and the attributes defined below.
@author- Designates the originator of the draft comment.
@disposition- Specifies the status of the draft comment.
@time- Specifies when the draft comment was created.
For this element, the
@translate attribute has a default value of no.
The following attributes are available on this element: universal attributes and the attributes defined below.
@author- Designates the originator of the draft comment.
@disposition- Specifies the status of the draft comment.
@time- Specifies when the draft comment was created.
@translate- For this element, the
@translateattribute has a default value of no.
Example
This section is non-normative.
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>
</draft-comment>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.