draft-comment

Darwin Information Typing Architecture (DITA) Version 1.3 Part 1: Base Edition

version
1.3
author
OASIS DITA Technical Committee

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.