11.3.2 Comments Part

Content Type:

application/vnd.openxmlformats-officedocument.wordprocessingml.comments+xml

Root Namespace:

http://purl.oclc.org/ooxml/wordprocessingml/main

Source Relationship:

http://purl.oclc.org/ooxml/officeDocument/relationships/comments

An instance of this part type contains the information about each comment in the document.

A package shall contain no more than two Comments parts. If it exists, one instance of that part shall be the target of an implicit relationship from the Main Document (11.3.10) part, and the other shall be the target of an implicit relationship from the Glossary Document (11.3.8) part.

[Example: The following Main Document part-relationship item contains a relationship to the Contents part, which is stored as the ZIP item comment.xml:

<Relationships xmlns="…">
  <Relationship Id="rId93"
    Type="http://…/comments" Target="comments.xml"/>
</Relationships>

end example]

The root element for a Comment part shall be comments.

[Example:

<w:comments … >
  <w:comment>
    …
  </w:comment>
  …
</w:comments>

end example]

The XML markup for a comment in a Main Document part uses the commentReference element.

[Example: Consider the case in which the Main Document part contains the text “… in the Standard.”, and there is an comment inserted immediately after the period:

<w:p …>
  …
  <w:r>
    <w:t>… in the Standard.</w:t>
  </w:r>
  <w:r>
    <w:commentReference w:id="1"/>
  </w:r>
</w:p>

end example]

Each comment has a corresponding comment element in the Comments part, which contains the text of the comment.

[Example: The text of the comment is “This is my comment.”:

<w:comments xmlns:w="…"
  <w:comment w:id="1">
    <w:p>
      <w:r>
        <w:t>This is my comment.</w:t>
    </w:p>
  </w:comment>
</w:comments>

end example]

A Comments part shall be located within the package containing the relationships part (expressed syntactically, the TargetMode attribute of the Relationship element shall be Internal).

A Comments part is permitted to contain explicit relationships to the following parts defined by ISO/IEC 29500:

• Alternative Format Import (11.3.1)
• Chart (14.2.1)
• Content Part (15.2.4)
• Diagrams: Diagram Colors(14.2.3), Diagram Data(14.2.4), Diagram Layout Definition(14.2.5) and
• Diagram Styles (14.2.6)
• Embedded Control Persistence (15.2.9)
• Embedded Object (15.2.10)
• Embedded Package (15.2.11)
• Hyperlinks (15.3)
• Images (15.2.14)
• Video (15.2.17)

A Comments part shall not have any implicit or explicit relationships to any other part defined by ISO/IEC 29500.