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
<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
- See Using the -dita-use-conref-target value for more information.
- 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.