Review

Author: quinntracy

content/en/docs/refguide/modeling/menus/version-control-menu/history-dialog.md

@@ -2,22 +2,23 @@
 title: "History"
 url: /refguide/history-dialog/
 weight: 50
+description: "Describes the History pane in Studio Pro, which shows committed changes to an app's development line."
 ---
 ## Introduction
 
-Use the **History** pane to see the changes that have been committed to a development line of an app. You can open this pane from the **Version Control** > **History…** menu item. The **History** pane displays all revisions at once in a searchable grid, making it easy to view the detailed project history.
+Use the **History** pane to see the changes that have been committed to a development line of an app. You can open this pane by selecting **Version Control** > **History** from the menu. The **History** pane displays all revisions at once in a searchable grid, making it easy to view the detailed project history.
 
 {{% alert color="info" %}}
-In Studio Pro 11.6, a new default view for History was introduced. Partially-cloned apps automatically get the older blocking dialog and through the [Version Control Preferences](/refguide/preferences-dialog/#history-pane), you can choose to keep using the blocking dialog for all apps.
+Studio Pro 11.6 introduced a new default view for History. Partially cloned apps automatically use the older blocking dialog. You can also choose to keep using the blocking dialog for all apps through the [Version Control Preferences](/refguide/preferences-dialog/#history-pane).
 
-When using the Revision Selector to select a revision to revert, to merge from, create a branch line off, or to create a deployment archive from, the blocking dialog is still used.
+The Revision Selector still uses the blocking dialog when you select a revision to revert, merge from, create a branch line from, or create a deployment archive from.
 
-For more information on the blocking dialog, refer to the [Mendix 10 documentation](/refguide10/history-dialog/).
+For more information on the blocking dialog, see the [Mendix 10 documentation](/refguide10/history-dialog/).
 {{% /alert %}}
 
 ## Revisions
 
-{{< figure src="/attachments/refguide/modeling/menus/version-control-menu/history-dialog/revisions.png" alt="Revisions Image" class="no-border" >}}
+{{< figure src="/attachments/refguide/modeling/menus/version-control-menu/history-dialog/revisions.png" alt="History pane showing a grid of revisions" class="no-border" >}}
 
 Each line in the grid represents a revision in the repository. 
 
@@ -43,9 +44,9 @@ By selecting a revision in this grid, the tabs below the grid will be filled wit
 
 ### Comparing Revisions
 
-You can compare any revision to your current working state by right-clicking a revision and selecting **Compare to current state**. This opens the [Comparison pane](/refguide/comparison-pane/), which shows all differences between the selected revision and your current state, including uncommitted changes.
+To compare any revision to your current working state, right-click a revision and select **Compare to current state**. This opens the [Comparison pane](/refguide/comparison-pane/), which shows all differences between the selected revision and your current state, including uncommitted changes.
 
-{{< figure src="/attachments/refguide/modeling/menus/view-menu/comparison-pane/history-right-click-menu.png" alt="Compare to current state in History dialog right-click menu" class="no-border" >}}
+{{< figure src="/attachments/refguide/modeling/menus/view-menu/comparison-pane/history-right-click-menu.png" alt="Right-click menu showing Compare to current state option" class="no-border" >}}
 
 For more information, see [Comparing Revisions](/refguide/comparing-revisions/).
 

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 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.
+The [Comparison pane](/refguide/comparison-pane/) shows the differences between a selected historical revision and your current working state, which allows you to see what documents, elements, and properties changed.
 
 ### History {#history-pane}
 

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

@@ -12,19 +12,19 @@ The **Comparison** pane shows the differences between a selected historical revi
 This feature requires a version-controlled app. For apps without version control, the **Comparison** pane is disabled.
 
 {{% alert color="warning" %}}
-The key limitation of the **Comparison** pane is that you can only compare a selected historical revision to your current working state. It is not possible to compare two past revisions to each other.
+You can only compare a selected historical revision to your current working state. It is not possible to compare two past revisions to each other.
 {{% /alert %}}
 
 This feature is similar to the [Changes pane](/refguide/changes-pane/), but while the **Changes** pane shows your local modifications since your last commit, the **Comparison** pane shows differences between any historical revision and your current state.
 
-For more information on comparing scenarios, see [Comparing Revisions](/refguide/comparing-revisions/).
+For more information on comparing scenarios, refer to [Comparing Revisions](/refguide/comparing-revisions/).
 
 ## Accessing the Comparison Pane and Version Compatibility
 
 To compare a revision to your current state, do the following:
 
 1. Open the **History** dialog by clicking **View** > **History**.
-2. Choose a revision from the list by right-clicking it. 
+2. Right-click a revision from the list. 
 3. Select **Compare to current state**.
 
 The **Comparison** pane opens and shows all differences between the selected revision and your current working state, including any uncommitted changes.
@@ -39,11 +39,11 @@ When comparing revisions created in older versions of Studio Pro, the models are
 
 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.
+* **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.
+Navigate between levels by double-clicking a row or clicking **Go to**. Press <kbd>Backspace</kbd> or click **Back** to return to the previous level.
 
 ### Unversioned App State
 
@@ -91,7 +91,7 @@ The **Status** column shows one of the following types:
 
 ## Level 2 and 3: Element and Property Differences
 
-Double-clicking a document in Level 1 navigates to Level 2 and Level 3, which appear side by side. Level 2 shows changed elements, and Level 3 shows the property differences for the selected element.
+Double-click a document in Level 1 to navigate to Level 2 and Level 3, which appear side by side. Level 2 shows changed elements, and Level 3 shows the property differences for the selected element.
 
 {{< figure src="/attachments/refguide/modeling/menus/view-menu/comparison-pane/comparison-pane-level2-3.png" alt="Comparison Pane Level 2 and Level 3 showing element and property differences" class="no-border" >}}
 
@@ -117,7 +117,7 @@ The Level 2 grid shows all changed elements within the selected document:
 
 | Column | Description | What It Shows |
 |--------|-------------|---------------|
-| **Status** | The type of change | An icon and label indicating whether the element was Added, Modified, or Deleted |
+| **Status** | The type of change | An icon and label indicating whether the element was added, modified, or deleted |
 | **Item** | The element name | The name of the changed element (for example, a widget, entity, or activity) |
 
 Hover over any cell to see the full value in a tooltip.
@@ -144,11 +144,11 @@ In future releases, both versions of the document will be opened side by side fo
 
 ## Refresh Behavior
 
-When you are comparing a revision to your current state and you save changes to your app, a **Refresh** button appears in the **Comparison** pane. Click **Refresh** to update the comparison with your latest saved changes.
+When you are comparing a revision to your current state and save changes to your app, a **Refresh** button appears in the **Comparison** pane. Click **Refresh** to update the comparison with your latest saved changes.
 
 ## Stopping a Comparison
 
-Click the **Stop comparison** button to close the comparison. This action closes the **Comparison** pane and returns it to a blank state. Any documents that were opened as part of the comparison remain open in the editor.
+Click **Stop comparison** to close the comparison. This action closes the **Comparison** pane and returns it to a blank state. Any documents that were opened as part of the comparison remain open in the editor.
 
 In the blank state, the **Comparison** pane displays a message with a link to start a new comparison. The **Go to** and **Stop comparison** buttons are disabled until a new comparison is started.
 

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/_index.md

@@ -13,6 +13,6 @@ description_list: true
 
 This document describes how to use [version control](/refguide/version-control/) in Mendix Studio Pro. 
 
-For more information on related concepts and the theory behind how version control works in Mendix, see [Version Control](/refguide/version-control/).
+For more information on related concepts and the theory behind how version control works in Mendix, refer to [Version Control](/refguide/version-control/).
 
 ## Read More

content/en/docs/refguide/version-control/using-version-control-in-studio-pro/comparing-revisions.md

@@ -7,52 +7,52 @@ description: "How to compare a historical revision to your current state to unde
 
 ## Introduction
 
-You can compare any historical revision of your version-controlled app to your current working state via the **Comparison** pane. It can help you understand what has changed since a specific commit, see the impact of your recent edits, or review what is affected if you reverted to a past revision.
+You can compare any historical revision of your version-controlled app to your current working state using the [Comparison pane](/refguide/comparison-pane/). This helps you understand what has changed since a specific commit, see the impact of your recent edits, or review what is affected if you revert to a past revision.
 
 The comparison shows differences between:
 
-* **Older revision** – The historical revision you selected from the **History** pane
-* **Newer revision** – Your current working state, including all uncommitted changes
+* **Older revision** – the historical revision you selected from the **History** pane
+* **Newer revision** – your current working state, including all uncommitted changes
 
-As the comparison always includes your current uncommitted changes, you can use this feature to see how your recent edits differ from any point in your app's history.
+The comparison always includes your current uncommitted changes, so you can use this feature to see how your recent edits differ from any point in your app's history.
 
 {{% alert color="warning" %}}
-The key limitation of the **Comparison** pane is that you can only compare a selected historical revision to your current working state. It is not possible to compare two arbitrary past revisions to each other.
+You can only compare a selected historical revision to your current working state. It is not possible to compare two arbitrary past revisions to each other.
 {{% /alert %}}
 
-For more information on the **Comparison** pane and its detailed overview, see [Comparison Pane](/refguide/comparison-pane/).
+For more information on the **Comparison** pane and its detailed overview, refer to [Comparison Pane](/refguide/comparison-pane/).
 
 ## Common Scenarios
 
 ### What Changed Since a Specific Commit?
 
-You can review all changes made since a specific commit, which helps you understand the scope of work done since the selected commit, made by you or other team members.
+You can review all changes made since a specific commit. This helps you understand the scope of work done since the selected commit, made by you or other team members.
 
 ### What Would Reverting to This Revision Undo?
 
 Before reverting to an older revision, you can compare your current changes to a revision you are considering reverting to and review what changes will be lost. This helps you make an informed decision about whether reverting is safe or if it would undo important work.
 
 ### Will My Recent Changes Affect a Specific Area?
 
-To check if your recent uncommitted changes affected a specific area of your app:
+To check if your recent uncommitted changes affected a specific area of your app, do the following:
 
 1. Open the **History** dialog and select your most recent commit (HEAD).
 2. Right-click and select **Compare to current state**.
 3. Look for the documents or elements you are concerned about.
 
-As the comparison includes uncommitted changes, you can see the full impact of your current working session.
+Because the comparison includes uncommitted changes, you can see the full impact of your current working session.
 
 ## Tips and Tricks
 
-* **Use Expand all and Collapse all** in Level 3 to quickly show or hide all nested property paths. This is especially useful when comparing complex elements with many properties.
-* **Right-click any cell** in the grids and select **Copy** to copy the cell value to your clipboard. This is useful for documenting changes or sharing information with your team.
-* **Press <kbd>Enter</kbd> to drill down** and <kbd>Backspace</kbd> to go back when navigating the comparison. This is faster than using the mouse to click buttons.
-* **Understand version conversions** – When comparing older revisions, remember that model conversions may introduce minor differences in how properties are displayed. These do not affect your stored revisions.
+* **Use Expand all and Collapse all** –  In Level 3, use these options to quickly show or hide all nested property paths. This is especially useful when comparing complex elements with many properties.
+* **Right-click any cell** – In the grids, right-click any cell and select **Copy** to copy the cell value to your clipboard. This is useful for documenting changes or sharing information with your team.
+* **Press <kbd>Enter</kbd> to drill down** and <kbd>Backspace</kbd> to go back – Use these shortcuts while when navigating the comparison. This is faster than using the mouse to click buttons.
+* **Understand version conversions** – When comparing older revisions, remember that model conversions may introduce minor differences in how properties are displayed. These differences do not affect your stored revisions.
 
 ## Read More
 
 * [Comparison Pane](/refguide/comparison-pane/)
 * [History](/refguide/history-dialog/)
 * [Changes Pane](/refguide/changes-pane/)
 * [Version Control](/refguide/version-control/)
-* [Using Version Control History](/refguide/peer-review/)
+* [Using Version Control History](/refguide/version-control-using-history/)