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

<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.