v0.3.0

What's Changed

Added

• delete_comment() and delete_thread() for removing comments and threads
• move_comment() and move_thread() for re-anchoring comments to different text
• unresolve_comment() and set_comment_resolved() for toggling done status

Improved

• Archive script now handles branch divergence gracefully with --ff-only

Full Changelog: v0.2.0...v0.3.0

v0.2.0

docx-comments v0.2.0

Release date: 2026-01-21

Highlights

• New optional people.xml identity linkage for comment authors
• New PersonInfo model with presence metadata support
• New CommentManager people APIs: get_people, get_person, ensure_person,
  merge_people_from, get_default_author_person
• Default author resolution from Office profiles or a DOCX source via
  DOCX_COMMENTS_AUTHOR_DOCX

Breaking change

• The author argument now requires PersonInfo (instead of a raw string) when
  adding or replying to comments. Update call sites accordingly.

v0.1.1

Release v0.1.1

v0.1.0

Initial Release

Python module for complete Word document comment manipulation with threading support and Word Online compatibility.

Features

• CommentManager class for managing Word document comments
• add_comment() - Add anchored comments to specific text ranges
• reply_to_comment() - Create threaded replies to existing comments
• resolve_comment() - Mark comments as resolved (done status)
• list_comments() - List all comments in the document
• get_comment_threads() - Get comments grouped by thread
• Full Word Online compatibility with proper OOXML structure
• Support for all four comment-related XML parts:
  • comments.xml - Comment content
  • document.xml - Anchors (commentRangeStart/End, commentReference)
  • commentsExtended.xml - Threading (paraId, paraIdParent, done)
  • commentsIds.xml - Durable IDs

Installation

pip install docx-comments