added missing parts

YanaLitvinchik · YanaLitvinchik · commit cb40159042b1 · 2025-09-16T21:07:11.000+03:00
diff --git a/python-net/advanced-usage/comparison/accept-or-reject-detected-changes.md b/python-net/advanced-usage/comparison/accept-or-reject-detected-changes.md
@@ -56,6 +56,12 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Remove undesired edits from the final deliverable while keeping approved changes.
 
+The result is as follows:
+
+|                            Accepted changes                             |                             Rejected changes                            |
+| :-----------------------------------------------------------------: | :----------------------------------------------------------------: |
+| ![](/comparison/python-net/images/accepted-changes.png) | ![](/comparison/python-net/images/rejected-changes.png) |
+
 ## Accept or reject changes (streams)
 
 Work entirely with streams and persist the merged result.
diff --git a/python-net/advanced-usage/comparison/accept-or-reject-revisions.md b/python-net/advanced-usage/comparison/accept-or-reject-revisions.md
@@ -117,4 +117,13 @@ with RevisionHandler(source_path) as revision_handler:
     options.common_handler = RevisionAction.Accept
 
     revision_handler.apply_revision_changes(result_path, options)
-```
+```
+
+
+## Result of revision processing
+
+Below are the source and output files based on the code presented earlier.
+
+| Source file                                   | Result file                                          |
+| --------------------------------------------- | ---------------------------------------------------- |
+| ![](/comparison/net/images/revision-file.png) | ![](/comparison/python-net/images/result-revision-file.png) |
diff --git a/python-net/advanced-usage/comparison/adjusting-comparison-sensitivity.md b/python-net/advanced-usage/comparison/adjusting-comparison-sensitivity.md
@@ -32,6 +32,36 @@ structuredData:
 
 [GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) supports sensitivity levels from 0 (fastest, least detailed) to 100 (slowest, most detailed).
 
+[GroupDocs.Comparison](https://products.groupdocs.com/comparison/net) allows you to adjust comparison sensitivity to achieve the necessary balance between the comparison speed and accuracy. Possible comparison sensitivity values range is from **0** to **100**.
+
+- **Minimal value** (**0**) sets sensitivity to a minimal value provides the fastest comparison speed, but it may produce worst comparison quality. If there is at least one common letter in two compared words then these words are not treated as fully inserted and deleted
+- **Value by default** means **75**. Comparison occurs when the percentage of deleted or inserted elements in relation to all elements does not exceed 75%
+- **Maximum value** (**100**) provides the best quality, but slowest comparison speed. Comparison occurs at any length of a common sub-sequence of two compared objects
+
+For better understanding about how comparison algorithms work let's suppose we have two strings:
+
+| Strings                          |
+| -------------------------------- |
+| ` 1``. It is our equity poetry ` |
+| ` 2``. Jack is a glad calf `     |
+
+So, these strings have two common sub-sequences: "**is**" word and 4 space symbols.   
+Common sub-sequence is - " **is** " and its length is 4 symbols (there are 2 space symbols in it).  
+Length of inserted sub-sequence is 13 symbols - **Jackagladcalf**  
+Removed sub-sequence length is 17 symbols - **Itourequitypoetry\*_  
+Lets calculate percent of removed and inserted symbols: (17 + 13) / (17 + 13 + 4) * 100 = 88%
+
+*Case 1.* If **SensitivityOfComparison = 80%** comparison of these two strings produces the next result:  
+**Jack is a glad calfIt is our equity poetry**
+
+Because calculated percent of removed and inserted symbols equals **88%** and it is bigger than value of **SensitivityOfComparison** equals **80%** then this common sub-sequence will be not taken into account.  
+The first string considered completely removed and the second string considered completely inserted. The same results are produced for any calculated percent less than **83%**.
+
+_Case 2._ If **SensitivityOfComparison = 89%**, comparison of these two strings produces the next result:  
+**JackIt is aour gladequity calfpoetry**
+
+Common sub-sequence was found, because **89% > 88%**. The same results are produced for any calculated percent bigger than **88%**.
+
 ## Adjust overall sensitivity
 
 Increase sensitivity to detect smaller changes or reduce it for faster processing.
diff --git a/python-net/advanced-usage/comparison/compare-bookmarks-in-word.md b/python-net/advanced-usage/comparison/compare-bookmarks-in-word.md
@@ -48,4 +48,8 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Validate that critical bookmarked sections (e.g., clauses) remain unchanged.
 
+The result is as follows:
+
+![](/comparison/python-net/images/compared-bookmarks.png)
+
 
diff --git a/python-net/advanced-usage/comparison/customize-changes-styles.md b/python-net/advanced-usage/comparison/customize-changes-styles.md
@@ -34,8 +34,6 @@ structuredData:
 
 To compare two documents with custom change style settings, follow these steps:
 
-🔹 Use case: Enforce brand-compliant highlighting for insertions, deletions, and edits in legal reviews.
-
 1. Instantiate the `Comparer` object with a source path or stream.
 2. Call `add()` and provide the target path or stream.
 3. Instantiate `CompareOptions` and configure `InsertedItemStyle`, `DeletedItemStyle`, and `ChangedItemStyle`.
diff --git a/python-net/advanced-usage/comparison/disable-image-comparison-in-pdf-documents.md b/python-net/advanced-usage/comparison/disable-image-comparison-in-pdf-documents.md
@@ -49,4 +49,8 @@ with gc.Comparer("source.pdf") as comparer:
 
 🔹 Use case: Speed up PDF comparisons and avoid noise from embedded graphics.
 
+The result is as follows:
+
+![](/comparison/python-net/images/disable-image-comparison-in-pdf-documents.png)
+
 
diff --git a/python-net/advanced-usage/comparison/get-changes-coordinates.md b/python-net/advanced-usage/comparison/get-changes-coordinates.md
@@ -51,4 +51,8 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Draw bounding boxes over preview images to visualize change locations.
 
+The result is as follows:
+
+![](/comparison/python-net/images/get-changes-coordinates.png)
+
 
diff --git a/python-net/advanced-usage/comparison/get-extended-information-on-the-summary-page.md b/python-net/advanced-usage/comparison/get-extended-information-on-the-summary-page.md
@@ -49,3 +49,10 @@ with gc.Comparer("source.docx") as comparer:
 🔹 Use case: Provide management with detailed metrics beyond the standard summary counts.
 
 
+The result is as follows:
+
+![](/comparison/python-net/images/how-to-get-extended-information-image.png)
+
+
+
+
diff --git a/python-net/advanced-usage/comparison/get-list-of-changes.md b/python-net/advanced-usage/comparison/get-list-of-changes.md
@@ -49,6 +49,10 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Build a custom report UI that lists all differences with pagination info.
 
+The result is as follows:
+
+![](/comparison/python-net/images/get-changes-list.png)
+
 ## Get list of changes from stream
 
 Compare from streams and retrieve the changes programmatically.
diff --git a/python-net/advanced-usage/comparison/get-only-summary-page.md b/python-net/advanced-usage/comparison/get-only-summary-page.md
@@ -48,4 +48,8 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Share a concise overview of differences without exposing full document content.
 
+The result is as follows:
+
+![](/comparison/python-net/images/get-only-summary-page.png)
+
 
diff --git a/python-net/advanced-usage/comparison/how-to-merge-source-code-files.md b/python-net/advanced-usage/comparison/how-to-merge-source-code-files.md
@@ -32,32 +32,80 @@ structuredData:
         text: Call apply_changes() with ApplyChangeOptions to produce the merged file.
 ---
 
-[GroupDocs.Comparison for Python via .NET](https://products.groupdocs.com/comparison/python-net) lets you control merging by accepting or rejecting individual changes before applying them.
+# Merging Source Code Files in Python
 
-## Merge changes programmatically
+GroupDocs.Comparison allows you to merge source code files by using the `ComparisonAction`property:
 
-Accept or reject changes and apply them into a final document.
+- `ComparisonAction.Accept` accepts the found changes and adds them to the file without highlighting
+- `ComparisonAction.Reject` rejects the found changes and removes them from the output file
+
+---
+
+## Steps to apply or reject changes
+
+1. Instantiate the `Comparer` object. Specify the source document path or stream.  
+2. Call the `add` method. Specify the target document path or stream.  
+3. Call the `compare` method.  
+4. Call the `get_changes`) method to get the list of changes.  
+5. Set the `comparison_action` property of the appropriate change object to either `ComparisonAction.ACCEPT` or `ComparisonAction.REJECT`.  
+6. Call the `apply_changes` method. Pass the collection of changes to apply.  
+
+---
+
+## Example scenario
+
+You need to compare and merge several versions of source code files and selectively accept or discard changes made by different authors.
+
+**Before comparison:**  
+![Source file](/comparison/python-net/images/how-to-merge-source-code-file-source.png)  
+![Target file](/comparison/python-net/images/how-to-merge-source-code-file-target.png)
+
+The differences show that two methods are in the **source.cs** file: `AddNumbers` and `Sum`.
+
+If you do not use the `comparison_action` property, all changes are automatically applied to the output file, and these methods are removed. If you need to control the merging process, the `comparison_action` property helps you do that.
+
+---
+
+## Python example: merge two source code files
 
 ```python
 import groupdocs.comparison as gc
+from groupdocs.comparison.result import ComparisonAction
+from groupdocs.comparison.options import ApplyChangeOptions
 
 with gc.Comparer("source.docx") as comparer:
     comparer.add("target.docx")
     comparer.compare("result.docx")
 
     changes = comparer.get_changes()
-    for index, change in enumerate(changes):
-        if index < 10:
-            change.comparison_action = gc.ComparisonAction.ACCEPT
-        else:
-            change.comparison_action = gc.ComparisonAction.REJECT
-
-    apply_options = gc.ApplyChangeOptions()
-    apply_options.changes = changes
-    with open("result.docx", "wb") as out_stream:
-        comparer.apply_changes(out_stream, apply_options)
+
+    # Accept first 10 changes
+    for i in range(min(10, len(changes))):
+        changes[i].comparison_action = ComparisonAction.ACCEPT
+
+    # Reject the rest
+    for i in range(10, len(changes)):
+        changes[i].comparison_action = ComparisonAction.REJECT
+
+    options = ApplyChangeOptions()
+    options.changes = changes
+    with open("result.docx", "wb") as result_file:
+        comparer.apply_changes(result_file, options)
 ```
 
-🔹 Use case: Curate diffs in code or text files to retain intended edits and discard noise.
+---
+
+## Result
+
+As a result, you get a merged source code file where:  
+- Deleted elements are marked in **red**
+- Added elements are marked in **blue**
+- Modified elements are marked in **green**
+
+Also, you receive an HTML file that highlights all the changed places in the code.
 
+| Result source code file                                                 | Result HTML file                                                          |
+| ----------------------------------------------------------------------- | ------------------------------------------------------------------------- |
+| ![](/comparison/python-net/images/how-to-merge-source-code-file-result-CS.png) | ![](/comparison/python-net/images/how-to-merge-source-code-file-result-HTML.png) |
 
+As you can see from the resulting files, only one of the two methods was removed.
diff --git a/python-net/advanced-usage/comparison/set-shape-color-independently-of-font-color.md b/python-net/advanced-usage/comparison/set-shape-color-independently-of-font-color.md
@@ -62,3 +62,6 @@ with gc.Comparer("source.docx") as comparer:
 🔹 Use case: Emphasize shape modifications (e.g., diagrams) without altering text color coding.
 
 
+The result is as follows:
+
+![](/comparison/net/images/set-shape-color-independently-of-font-color.png)
diff --git a/python-net/advanced-usage/comparison/setting-author-of-changes.md b/python-net/advanced-usage/comparison/setting-author-of-changes.md
@@ -50,4 +50,6 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Attribute changes to a specific reviewer or automated system in audit trails.
 
+The result is as follows:
 
+ ![Change author](/comparison/net/images/set-new-author-of-changes-example.png)
diff --git a/python-net/advanced-usage/comparison/show-gap-lines.md b/python-net/advanced-usage/comparison/show-gap-lines.md
@@ -50,4 +50,14 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Provide redacted-style diffs that keep layout alignment without showing actual changed text.
 
+The result is as follows:
+
+|                        Default result                         |                Result without LeaveGaps property                 |
+| :-----------------------------------------------------------: | :--------------------------------------------------------------: |
+| ![](/comparison/python-net/images/show-gap-lines-default-result.png) | ![](/comparison/python-net/images/show-gap-lines-without-leavegaps.png) |
+
+|                        Default result                         |                Result with LeaveGaps property                 |
+| :-----------------------------------------------------------: | :-----------------------------------------------------------: |
+| ![](/comparison/python-net/images/show-gap-lines-default-result.png) | ![](/comparison/python-net/images/show-gap-lines-with-leavegaps.png) |
+
 
diff --git a/python-net/advanced-usage/comparison/show-revisions.md b/python-net/advanced-usage/comparison/show-revisions.md
@@ -48,4 +48,10 @@ with gc.Comparer("source.docx") as comparer:
 
 🔹 Use case: Produce a clean deliverable without inline revision markers for end users.
 
+The result is as follows:
+
+|              Disable display Revisions               |
+| :--------------------------------------------------: |
+| ![](/comparison/python-net/images/show-revisions-false.png) |
+
 
diff --git a/python-net/advanced-usage/comparison/word-track-changes.md b/python-net/advanced-usage/comparison/word-track-changes.md
@@ -70,4 +70,17 @@ with gc.Comparer("source-with-revisions.docx") as comparer:
 
 Note: Availability of particular options may depend on the document format and library version.
 
+The result is as follows:
+
+|                     WordTrackChanges true                      |
+| :------------------------------------------------------------: |
+| ![](/comparison/python-net/images/word-track-changes-option-true.png) |
+
+
+
+
+|                     WordTrackChanges false                      |
+| :-------------------------------------------------------------: |
+| ![](/comparison/python-net/images/word-track-changes-option-false.png) |
+
 
