draft-comment
The draft-comment element is designed to facilitate review and discussion of topic contents within the marked-up content. Use the draft-comment element to ask a question or to make a comment that you want others to review. To indicate the source of the draft comment or the status of the comment, use the author, time, or disposition attributes.
Processing systems SHOULD provide a mechanism that causes the content of this element to be rendered in draft output only. By default, processors SHOULD strip them out to prevent publishing internal comments by mistake.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
- topic/draft-comment
Example 65. Example
<draft-comment author="EBP">Where's the usage information for this
section?</draft-comment>
Attributes
The following attributes are available on this element:
Universal attribute group (with a narrowed definition for
translate, given below),
outputclass, and the attributes defined below.
translate
Indicates whether the content of the element should be translated or not. For this element the default value is "no". Setting to "yes" will override the default. The DITA architectural specification contains a list of each OASIS DITA element and its common processing default for the translate value; because this element uses an actual default, it will always be treated as translate="no" unless overridden as described. Available values are:
no
The content of this element is not translateable.
yes
The content of this element is translateable.
-dita-use-conref-target
author
Designates the originator of the draft comment.
time
Describes when the draft comment was created.
disposition
Status of the draft comment. Prior to DITA 1.2, this attribute was limited to the following values: issue, open, accepted, rejected, deferred, duplicate, reopened, unassigned, or completed.
Parent topic