# Explaining Contract Tracked Changes Automatically Using .NET C# and AI > Learn how to use AI and .NET C# to automatically explain changes to contracts, improving the document review and collaboration processes. This comprehensive guide provides practical implementation strategies and best practices. - **Author:** Bjoern Meyer - **Published:** 2026-01-09 - **Modified:** 2026-02-16 - **Description:** Learn how to use AI and .NET C# to automatically explain changes to contracts, improving the document review and collaboration processes. This comprehensive guide provides practical implementation strategies and best practices. - **10 min read** (1954 words) - **Tags:** - ASP.NET - ASP.NET Core - AI - Tracked Changes - **Web URL:** https://www.textcontrol.com/blog/2026/01/09/explaining-contract-tracked-changes-automatically-using-dotnet-csharp-and-ai/ - **LLMs URL:** https://www.textcontrol.com/blog/2026/01/09/explaining-contract-tracked-changes-automatically-using-dotnet-csharp-and-ai/llms.txt - **LLMs-Full URL:** https://www.textcontrol.com/blog/2026/01/09/explaining-contract-tracked-changes-automatically-using-dotnet-csharp-and-ai/llms-full.txt - **GitHub Repository:** https://github.com/TextControl/TXTextControl.AI.TrackedChanges --- ### Converting redlines and comments into straightforward, review-ready explanations for legal teams Anyone who has reviewed a heavily edited contract knows that the real challenge is not identifying what changed, but rather understanding why it changed. Tracked changes only show insertions and deletions. Comments and replies contain bits of reasoning. However, for lawyers and legal departments, this reasoning is often scattered across various comment threads, reviewers, and review rounds. This article introduces a practical, .NET-based concept that automatically explains tracked changes in contracts. It does so by connecting the changes to their underlying comments and using AI to summarize the rationale in a clear, consistent, review-ready manner. Built with TX Text Control for document structure and OpenAI for reasoning, the solution uses standard .NET C# code. #### The core problem in contract reviews In modern legal workflows, contracts rarely follow a direct path. Instead, they evolve through many hands over multiple review cycles, typically involving internal legal teams, external counsel, procurement departments, and business stakeholders. Each party contributes tracked changes, comments, and replies based on their priorities, expertise, and risk perspective. As this process unfolds, the document accumulates layers of edits and discussions. While tracked changes clearly show what was modified, they do not preserve the full context of why a modification was made. Comments may explain individual decisions, but they are often fragmented and spread across multiple threads or disconnected from the final wording of a clause. Over time, this creates several challenges. The original intent behind specific changes becomes difficult to understand, especially for reviewers who join the process later. Legal professionals must manually reconstruct the reasoning by reading numerous comments and replies across different versions of the document. During this manual process, there is a real risk that changes without proper justification will be overlooked or that significant legal modifications will slip through without sufficient scrutiny. Ultimately, what legal teams need is straightforward yet powerful: For every tracked change in a contract, there should be a clear explanation of the reason behind it—or an explicit indication that no justification exists. This clarity transforms contract review from a time-consuming forensic exercise into a focused legal assessment, enabling faster decisions and reducing risk. #### The key idea: Let the contract explain its own changes The solution presented here is based on a simple yet effective idea. Each tracked change in a contract should be paired with an explanation summarizing the rationale behind it. If an explanation does not exist, the system should explicitly state so. The approach follows four clear steps: - Collect all tracked changes in the document - Attach relevant comments and replies to each change - Use AI to generate concise explanations for each change based on the attached comments - Receive a clear explanation per change, backed by comment evidence Importantly, the AI is explicitly instructed to base its explanations solely on existing comments and replies within the document. It is not permitted to infer intent beyond what is documented or to fill in the gaps with assumptions or generalized legal reasoning. If available comments do not clearly justify a tracked change, the AI must state this explicitly and flag the change as lacking sufficient explanation. These constraints transform tracked changes from isolated redlines into an explainable contract history. Each modification is accompanied by a clear rationale or an explicit indication that further clarification is needed. This gives legal teams immediate insight into the intent and risk associated with every change. #### Step 1: Structuring tracked changes and comments using TX Text Control With TX Text Control, tracked changes and comments are treated as first-class objects. The key is to merge them into a structure that reflects how lawyers think. Each tracked change is represented by an object that holds references to related comments and replies. This structure makes it easy to traverse and associate changes with their justifications. Lawyers do not review APIs or technical abstractions. Instead, they review documents by focusing on three fundamental questions: What exactly changed? Why was that change made? And is the stated reason legally and commercially acceptable? Therefore, any system intended to support legal review must be built around this perspective and present information in a way that aligns with how legal professionals evaluate contracts. So we create a C# model that mirrors this mental model. ``` public sealed class TrackedChangeWithComments { public int ChangeNumber { get; set; } public int Start { get; set; } public int End { get; set; } public string ChangeKind { get; set; } public string Author { get; set; } public DateTime ChangeTime { get; set; } public string ChangedText { get; set; } public List Comments { get; set; } } ``` ##### Collecting tracked changes and comments with TX Text Control The first step is to load the document and iterate through its tracked changes and comments. With TX Text Control, both are available as structured collections. By matching their positions in the document, the comments that explain the tracked changes can be associated with them. ``` using TXTextControl; using System.Collections.Generic; public sealed class TrackedChangeWithComments { public int ChangeNumber { get; set; } public int Start { get; set; } public int End { get; set; } public TrackedChangeKind ChangeKind { get; set; } public string Author { get; set; } public string ChangedText { get; set; } public List Comments { get; set; } = new(); } public static List CollectTrackedChanges(ServerTextControl textControl) { var result = new List(); foreach (TrackedChange change in textControl.TrackedChanges) { int changeStart = change.Start; int changeEnd = change.Start + change.Length - 1; var entry = new TrackedChangeWithComments { ChangeNumber = change.Number, Start = changeStart, End = changeEnd, ChangeKind = change.ChangeKind, Author = change.UserName, ChangedText = change.Text }; // Attach comments that overlap with the tracked change range foreach (CommentedText comment in textControl.Comments) { int commentStart = comment.Start; int commentEnd = comment.Start + comment.Text.Length - 1; if (commentStart <= changeEnd && commentEnd >= changeStart) { entry.Comments.Add(comment); } } result.Add(entry); } return result; } ``` #### Step 2: Sending structured legal context to AI Now that the tracked changes and comments have been structured, the next step is to prepare the data for AI processing. The goal is to create a clear and concise prompt that gives the AI all the necessary context to generate accurate explanations. Instead of sending free-form text, the system serializes: - the full contract text - all tracked changes - all related comment threads into a single JSON payload. The following example illustrates the structure of the JSON sent to the AI model: ``` { "document": { "id": "Master_Service_Agreement_v3.docx", "fullText": "This Master Service Agreement (\"Agreement\") is entered into by and between..." }, "changes": [ { "changeNumber": 3, "start": 452, "length": 167, "end": 618, "changeKind": "Insertion", "author": "External Counsel", "changeTime": "2026-01-08T14:32:00Z", "changedText": "The liability of the Service Provider shall be limited to...", "comments": [ { "start": 452, "length": 167, "end": 618, "author": "External Counsel", "creationTime": "2026-01-08T14:34:00Z", "commentText": "Align limitation of liability with our standard template.", "commentedText": "The liability of the Service Provider shall be limited to...", "replies": [ { "start": 452, "length": 167, "end": 618, "author": "Internal Legal", "creationTime": "2026-01-08T15:02:00Z", "commentText": "Accepted. Updated to match the 2025 template wording.", "commentedText": "The liability of the Service Provider shall be limited to...", "replies": [] } ] } ] }, { "changeNumber": 7, "start": 1021, "length": 124, "end": 1144, "changeKind": "Deletion", "author": "Procurement", "changeTime": "2026-01-09T09:18:00Z", "changedText": "The customer shall provide quarterly forecasts...", "comments": [ { "start": 1021, "length": 124, "end": 1144, "author": "Procurement", "creationTime": "2026-01-09T09:20:00Z", "commentText": "This requirement is operationally difficult for the business.", "commentedText": "The customer shall provide quarterly forecasts...", "replies": [] } ] } ] } ``` #### Step 3: Enforcing structured, review-safe output Rather than allowing the AI to respond with free-form prose, the output is constrained to a strict JSON schema. This is a critical design decision for legal workflows because contract review requires consistency, traceability, and predictable results. While a narrative answer may sound convincing, it can be difficult to validate and compare across changes, as well as integrate into downstream review tooling. With a structured schema, the AI must produce the same set of fields for every tracked change. Each item contains a short, plain-language explanation of why the change was made, a list of quoted comments supporting that explanation, and a confidence score helping reviewers quickly identify items requiring closer attention. If the comments do not clearly justify a change, the AI must explicitly state so and add one or more open questions. This creates a reliable guardrail against invented intent because the system demands evidence and allows the model to admit uncertainty. The result is a review-safe output format in which every explanation is grounded in the document discussion. Unclear changes are highlighted instead of glossed over, and reviewers can trust the analysis because it is structured, inspectable, and easy to audit. The following JSON sample illustrates the expected output format: ``` { "overallSummary": "Most edits were made to clarify liability wording and align definitions with the latest company template. Two changes lack clear comment justification and should be confirmed with the author.", "changeAnalyses": [ { "changeNumber": 5, "explanation": "The limitation-of-liability clause was reworded to align with the standard template language requested by external counsel.", "supportingComments": [ { "author": "External Counsel", "quote": "Align this section with the standard limitation-of-liability language from the template." }, { "author": "Internal Legal", "quote": "Accepted. Updated clause to match our current template wording." } ], "confidence": 0.9, "openQuestions": [] }, { "changeNumber": 12, "explanation": "The change appears to narrow the scope of indemnification, but the attached comments do not clearly explain the intent behind this adjustment.", "supportingComments": [ { "author": "Procurement", "quote": "Can we make this less strict?" } ], "confidence": 0.52, "openQuestions": [ "Was the intent to narrow indemnification scope (legal risk change) or to simplify wording without changing meaning?", "Which template or precedent clause should this indemnification language match?" ] } ] } ``` #### Step 4: Presenting results for lawyers, not developers JSON is ideal for systems, but lawyers need clarity. That's why the analysis is converted into a readable format. For example: ``` Change #5 Confidence: 90% Reason ------ The clause was reworded to align with standard limitation-of-liability language. Supporting comments ------------------- - External Counsel: "Align with standard liability clause." ``` This information can be used in various ways. For example, it can be embedded directly into the document as annotations, displayed in a review dashboard alongside tracked changes, or exported to other legal review tools. The important point is that every tracked change is now accompanied by a clear, AI-generated explanation that legal teams can easily understand and act on. The complete output for a document with multiple tracked changes might look like this: ``` ======================================================================== TRACKED CHANGE ANALYSIS ======================================================================== Summary ------- Edits focus on shortening the introductory recital language. One deletion (Change 1) is contested in the comments and not fully supported as appropriate. ======================================================================== Change #1 Confidence: 45% Reason ------ Deleted a sentence because the author considered it unimportant, but a reply explicitly disagrees, so the comments do not clearly justify removing it. Supporting comments ------------------- - BjoernMeyer: "This part is not important." - : "I think that this is important" Open questions -------------- - Given the disagreement in the thread, should this recital sentence be retained, revised, or moved rather than deleted? What specific reason makes it 'important' (e.g., establishing purpose/consideration/scope)? ======================================================================== Change #2 Confidence: 78% Reason ------ Deleted the longer consideration phrase to create a shorter version of the introductory clause. Supporting comments ------------------- - BjoernMeyer: "Shorter version" ======================================================================== Change #3 Confidence: 30% Reason ------ Inserted "Therefore" (apparently to preserve the transition) after deleting the longer phrase, but there is no comment thread evidence explicitly explaining this insertion. Open questions -------------- - Is the intent of inserting "Therefore" to maintain grammar/flow after deleting the longer consideration language, or does it serve a substantive drafting purpose? ``` ### A pattern for modern legal document workflows Although contracts are the primary use case, the same pattern applies to: - Regulatory filings - Compliance documentation - Internal policies - Any legal document requiring review and approval Thanks to the precise document structure of TX Text Control and the reasoning capabilities of AI, .NET developers can build legal tools that are faster, safer, and easier to review. The system enforces structured input and output, ensuring that every tracked change aligns with legal workflows. This approach saves time and reduces risk by providing clear insights into the rationale behind every modification. --- ## About Bjoern Meyer As CEO, Bjoern is the visionary behind our strategic direction and business development, bridging the gap between our customers and engineering teams. His deep passion for coding and web technologies drives the creation of innovative products. If you're at a tech conference, be sure to stop by our booth - you'll most likely meet Bjoern in person. With an advanced graduate degree (Dipl. Inf.) in Computer Science, specializing in AI, from the University of Bremen, Bjoern brings significant expertise to his role. In his spare time, Bjoern enjoys running, paragliding, mountain biking, and playing the piano. - [LinkedIn](https://www.linkedin.com/in/bjoernmeyer/) - [X](https://x.com/txbjoern) - [GitHub](https://github.com/bjoerntx) --- ## Related Posts - [Introducing Text Control Agent Skills](https://www.textcontrol.com/blog/2026/03/27/introducing-text-control-agent-skills/llms.txt) - [Inspect and Process Track Changes in DOCX Documents with TX Text Control with .NET C#](https://www.textcontrol.com/blog/2026/03/10/inspect-and-process-track-changes-in-docx-documents-with-tx-text-control-with-dotnet-csharp/llms.txt) - [AI-Ready Legal Documents: What to Fix Before Adding AI](https://www.textcontrol.com/blog/2026/01/12/ai-ready-legal-documents-what-to-fix-before-adding-ai/llms.txt) - [Automating PDF/UA Accessibility with AI: Describing DOCX Documents Using TX Text Control and LLMs](https://www.textcontrol.com/blog/2025/10/16/automating-pdf-ua-accessibility-with-ai-describing-docx-documents-using-tx-text-control-and-llms/llms.txt) - [Transforming Legal Review with AI and TX Text Control: A Smarter, Faster Approach to Legal Document Processing in .NET C#](https://www.textcontrol.com/blog/2024/11/01/transforming-legal-review-with-ai-and-tx-text-control-a-smarter-faster-approach-to-legal-document-processing/llms.txt) - [Intelligent Document Processing (IDP) using TX Text Control in .NET C#](https://www.textcontrol.com/blog/2024/08/15/intelligent-document-processing-idp-using-tx-text-control-in-net-csharp/llms.txt) - [5 Layout Patterns for Integrating the TX Text Control Document Editor in ASP.NET Core C#](https://www.textcontrol.com/blog/2026/04/09/5-layout-patterns-for-integrating-the-tx-text-control-document-editor-in-aspnet-core-csharp/llms.txt) - [Extracting Structured Table Data from DOCX Word Documents in C# .NET with Domain-Aware Table Detection](https://www.textcontrol.com/blog/2026/04/03/extracting-structured-table-data-from-docx-word-documents-in-csharp-dotnet-with-domain-aware-table-detection/llms.txt) - [Deploying the TX Text Control Document Editor from the Private NuGet Feed to Azure App Services (Linux and Windows)](https://www.textcontrol.com/blog/2026/03/25/deploying-the-tx-text-control-document-editor-from-the-private-nuget-feed-to-azure-app-services-linux-and-windows/llms.txt) - [Why Structured E-Invoices Still Need Tamper Protection using C# and .NET](https://www.textcontrol.com/blog/2026/03/24/why-structured-e-invoices-still-need-tamper-protection-using-csharp-and-dotnet/llms.txt) - [AI Generated PDFs, PDF/UA, and Compliance Risk: Why Accessible Document Generation Must Be Built Into the Pipeline in C# .NET](https://www.textcontrol.com/blog/2026/03/23/ai-generated-pdfs-pdf-ua-and-compliance-risk-why-accessible-document-generation-must-be-built-into-the-pipeline-in-c-sharp-dot-net/llms.txt) - [File Based Document Repository with Version Control in .NET with TX Text Control](https://www.textcontrol.com/blog/2026/03/20/file-based-document-repository-with-version-control-in-dotnet/llms.txt) - [Create Fillable PDFs from HTML Forms in C# ASP.NET Core Using a WYSIWYG Template](https://www.textcontrol.com/blog/2026/03/17/create-fillable-pdfs-from-html-forms-in-csharp-aspnet-core-using-a-wysiwyg-template/llms.txt) - [Why HTML to PDF Conversion is Often the Wrong Choice for Business Documents in C# .NET](https://www.textcontrol.com/blog/2026/03/13/why-html-to-pdf-conversion-is-often-the-wrong-choice-for-business-documents-in-csharp-dot-net/llms.txt) - [Text Control at BASTA! Spring 2026 in Frankfurt](https://www.textcontrol.com/blog/2026/03/06/text-control-at-basta-spring-2026-in-frankfurt/llms.txt) - [From Legacy Microsoft Office Automation to a Future-Ready Document Pipeline with C# .NET](https://www.textcontrol.com/blog/2026/03/02/from-legacy-microsoft-office-automation-to-a-future-ready-document-pipeline-with-csharp-dot-net/llms.txt) - [We are Gold Partner at Techorama Belgium 2026](https://www.textcontrol.com/blog/2026/02/26/we-are-gold-partner-techorama-belgium-2026/llms.txt) - [Text Control Sponsors & Exhibits at BASTA! Spring 2026 in Frankfurt](https://www.textcontrol.com/blog/2026/02/26/text-control-sponsors-exhibits-basta-spring-2026-frankfurt/llms.txt) - [Azure DevOps with TX Text Control .NET Server 34.0: Private NuGet Feed and Azure Artifacts](https://www.textcontrol.com/blog/2026/02/25/azure-devops-with-tx-text-control-dotnet-server-34-0-private-nuget-feed-and-azure-artifacts/llms.txt) - [TX Text Control 34.0 SP2 is Now Available: What's New in the Latest Version](https://www.textcontrol.com/blog/2026/02/18/tx-text-control-34-0-sp2-is-now-available/llms.txt) - [Build a Custom Backstage View in ASP.NET Core with TX Text Control](https://www.textcontrol.com/blog/2026/02/17/build-a-custom-backstage-view-in-aspnet-core-with-tx-text-control/llms.txt) - [Configuring Web.Server.Core for TX Text Control Document Editor: Changing Ports and IP Versions](https://www.textcontrol.com/blog/2026/02/12/configuring-web-server-core-for-tx-text-control-document-editor-changing-ports-and-ip-versions/llms.txt) - [Software Origin, Compliance, and Trust: Made in Germany](https://www.textcontrol.com/blog/2026/02/11/software-origin-compliance-and-trust-made-in-germany/llms.txt) - [Building a TX Text Control Project with GitHub Actions and the Text Control NuGet Feed](https://www.textcontrol.com/blog/2026/02/09/building-a-tx-text-control-project-with-github-actions-and-the-text-control-nuget-feed/llms.txt) - [ASP.NET Core Document Editor with Backend via the Text Control Private NuGet Feed](https://www.textcontrol.com/blog/2026/02/09/aspnet-core-document-editor-private-nuget-feed/llms.txt)