Start a review

Author: MariaShaposhnikova

content/en/docs/refguide/modeling/menus/view-menu/_index.md

@@ -70,7 +70,7 @@ This pane has two levels, so when you zoom into a changed document, you can revi
 
 ### Comparison
 
-The [Comparison](/refguide/comparison-pane/) pane shows the differences between a selected historical revision and your current working state, allowing you to see what documents, elements, and properties changed.
+The [Comparison pane](/refguide/comparison-pane/) shows the differences between a selected historical revision and your current working state, allowing you to see what documents, elements, and properties changed.
 
 ### History {#history-pane}
 

content/en/docs/refguide/modeling/menus/view-menu/changes-pane.md

@@ -10,7 +10,7 @@ description: "Describes the Changes pane in Mendix Studio Pro."
 For version control enabled apps (apps with Team Server or other Git servers), the **Changes** pane shows the local changes to the app since the last commit. You can commit changes, update to the latest revision, and view the history from it. 
 
 {{% alert color="info" %}}
-The **Changes** pane shows your local changes since the last commit. To compare any historical revision to your current state, use the [Comparison Pane](/refguide/comparison-pane/) instead. For more information, see [Comparing Revisions](/refguide/comparing-revisions/).
+The **Changes** pane shows your local changes since the last commit. To compare any historical revision to your current state, use the [Comparison pane](/refguide/comparison-pane/) instead. For more information, see [Comparing Revisions](/refguide/comparing-revisions/).
 {{% /alert %}}
 
 This pane consists of the following:

content/en/docs/refguide/modeling/menus/view-menu/comparison-pane.md

@@ -7,67 +7,61 @@ description: "Describes the Comparison Pane in Mendix Studio Pro for comparing a
 
 ## Introduction
 
-The **Comparison Pane** shows the differences between a selected historical revision and your current working state in a version-controlled app. This pane displays three levels of detail: which documents changed, which elements within those documents changed, and which property values differ.
+The **Comparison** pane shows the differences between a selected historical revision and your current working state in a version-controlled app. This pane displays three levels of detail: which documents have changed, which elements within those documents have been altered, and which property values now differ.
 
-This feature requires a version-controlled app. For apps without version control, the Comparison Pane is disabled.
+This feature requires a version-controlled app. For apps without version control, the **Comparison** pane is disabled.
 
-## Accessing the Comparison Pane
+## Accessing the Comparison Pane and Version Compatibility
 
-To compare a revision to your current state:
+To compare a revision to your current state, do the following:
 
-1. Open the History pane by clicking **View** > **History**.
-2. Right-click any revision in the list.
+1. Open the **History** dialog by clicking **View** > **History**.
+2. Choose a revision from the list by right-clicking it. 
 3. Select **Compare to current state**.
 
-{{< figure src="/attachments/refguide/modeling/menus/view-menu/comparison-pane/history-right-click-menu.png" alt="Compare to current state option in History pane right-click menu" class="no-border" >}}
+    {{< figure src="/attachments/refguide/modeling/menus/view-menu/comparison-pane/history-right-click-menu.png" alt="Compare to current state option in History pane right-click menu" class="no-border" >}}
 
-The Comparison Pane opens and shows all differences between the selected revision and your current working state, including any uncommitted changes.
-
-## Version Compatibility
+The **Comparison** pane opens and shows all differences between the selected revision and your current working state, including any uncommitted changes.
 
 {{% alert color="warning" %}}
-When comparing revisions created in older versions of Studio Pro, the models are converted on-the-fly to the current Studio Pro version format. Due to this automatic conversion, the displayed older revision may not be 100% identical to the original model. This is a normal part of the version upgrade process and does not affect your actual stored revisions.
+When comparing revisions created in older versions of Studio Pro, the models are automatically converted to the current Studio Pro version format. Due to this automatic conversion, the displayed older revision may not be 100% identical to the original model. This is a normal part of the version upgrade process and does not affect your actual stored revisions.
 {{% /alert %}}
 
-## Comparison Pane Structure
+## Comparison Pane Overview
 
-The Comparison Pane shows information at three levels:
+The **Comparison** pane shows information at three levels:
 
 * **Level 1** – A list of all documents that differ between the two revisions
 * **Level 2** – All elements within a selected document that have changed
 * **Level 3** – The specific property values that differ for a selected element
 
 You can navigate between levels by double-clicking a row or using the **Go to** button. Press <kbd>Backspace</kbd> or click **Back** to return to the previous level.
 
-## Unversioned App State
-
-If your app does not have version control enabled, all buttons in the Comparison Pane are disabled and a message indicates that version control is required.
-
-## Loading State
+### Unversioned App State
 
-When starting a comparison or performing other operations that take more than a few seconds, a spinner is displayed to indicate the comparison is loading.
+If your app does not have version control enabled, all buttons in the **Comparison** pane are disabled and a message indicates that version control is required.
 
-## Level 1: Document List
+### Level 1: Document List
 
 Level 1 displays all documents that differ between the selected revision and your current state.
 
 {{< figure src="/attachments/refguide/modeling/menus/view-menu/comparison-pane/comparison-pane-level1.png" alt="Comparison Pane Level 1 showing document list" class="no-border" >}}
 
-### Task Bar
+#### Task Bar
 
 The task bar contains the following buttons:
 
 | Button | Action | When Enabled |
 |--------|--------|--------------|
-| **Back** | Returns to the previous level | Always disabled at Level 1 (kept to prevent layout shift) |
-| **Go to** | Opens the selected document and navigates to Level 2/3 | Enabled when a document is selected |
+| **Back** | Returns to the previous level | Always disabled at Level 1 (to prevent layout shift) |
+| **Go to** | Opens the selected document and navigates to Level 2 or 3 | Enabled when a document is selected |
 | **Stop comparison** | Closes the comparison and returns to the blank state | Always enabled during an active comparison |
 
-### Context Menu
+#### Context Menu
 
 Right-click any cell in the grid to access the **Copy** option, which copies the cell value to your clipboard.
 
-### Grid Columns
+#### Grid Columns
 
 The document list grid contains the following columns:
 
@@ -79,9 +73,9 @@ The document list grid contains the following columns:
 
 All columns are sortable by clicking the column header. Column widths can be adjusted by dragging the column divider. Hover over any cell to see the full value in a tooltip.
 
-### Status Types
+#### Status Types
 
-The Status column shows one of the following types:
+The **Status** column shows one of the following types:
 
 | Status | Icon | Meaning | When It Appears |
 |--------|------|---------|-----------------|