Engineering

Notes from the team.

Upstream contributions, deep-dives on the document tooling we build, and reference notes drawn from our own test suite.

1. 06.04.26

   Round-trip fidelity and tracked changes: where safe-docx and python-docx differ

   python-docx is excellent at generating and modifying Word documents, but tracked changes and redline output are not its job. This is why brownfield editing of existing .docx files — with revisions preserved — needs a different tool.

2. 04.19.26

   Patching a CharacterData state drift in xmldom

   We diagnosed and upstreamed a fix for xmldom CharacterData state drift: data and nodeValue were separate backing fields, so direct assignment to one could leave the other stale and cause XMLSerializer to emit outdated content.