Run editor assistant against source

Author: nrichers

site/guide/swap-documentation-templates.qmd

@@ -3,74 +3,70 @@ title: "Swap documentation templates"
 date: last-modified
 ---
 
-Swapping templates allows you to switch to a completely different template, upgrade to a more recent version of your current template, or make changes to both the template and template version at the same time.
+Swapping templates allows you to switch between different templates, upgrade to a newer version of your current template, or modify both the template and its version simultaneously.
 
-When swapping templates, only the document structure is changed. Any modifications that you might have made to content is preserved inside each content block or section. If you are not sure which template or which version of a template your model documentation or validation report is using, you can also check and compare between different templates and versions of templates.
+When swapping templates, only the document structure is affected. Modifications made to content are preserved within each content block or section. To determine which template or version is in use for model documentation or validation reports, you can check and compare different templates and versions.
 
 ## Prerequisites
 
-- You must hold the `Developer` role to update the template for model documentation.
-- You must hold the `Validator` role to update the template for validation reports.
+- The `Developer` role is required to update the template for model documentation.
+- The `Validator` role is required to update the template for validation reports.
 
 ## View current templates
 
 1. [Log in to the ValidMind UI]({{< var vm_ui >}}).
 
-2. In the left sidebar, click [**Model Inventory**](https://app.prod.validmind.ai/model-inventory).
+2. Click [**Model Inventory**](https://app.prod.validmind.ai/model-inventory) in the left sidebar.
 
-3. Select a model by clicking on it or find your model by applying a filter or searching for it.
+3. Find and select your model either by clicking on it directly or searching for it.
 
-4. In the left sidebar that appears for your model, click **Documentation**.
+4. For the selected model, click **Documentation** in the left sidebar.
 
-5. Check the right sidebar: 
-
-   - `Document Template` — lists the template used for model documentation
-   - `Validation Report Template` — lists the template used for validation reports
+5. In the right sidebar, check:
+   
+   - `Document Template` — shows the template for model documentation.
+   - `Validation Report Template` — shows the template for validation reports.
 
 ## Swap templates
 
 1. [Log in to the ValidMind UI]({{< var vm_ui >}}).
 
-2. In the left sidebar, click [**Model Inventory**](https://app.prod.validmind.ai/model-inventory).
+2. Click [**Model Inventory**](https://app.prod.validmind.ai/model-inventory) in the left sidebar.
 
-3. Select a model by clicking on it or find your model by applying a filter or searching for it.
+3. Locate and select your model.
 
-4. In the left sidebar that appears for your model, click **Documentation**.
+4. Click **Documentation** in the left sidebar for your model.
 
-5. In the right sidebar, select one of the templates currently in use under one of the following:
+5. In the right sidebar, under either:
 
    - **Document Template** 
    - **Validation Report Template**
 
-   The window pane that opens shows the YAML for the current template along with other information, such as the name and the current version, and which models are using this template.
+   select the template you are currently using. A window pane showing the current template YAML, its name, version, and which models are using it will open.
 
-6. Click **Swap Template**. 
+6. Click **Swap Template**. A pane with the YAML for two templates side-by-side will open:
 
-   The window pane now shows the YAML for two templates side-by-side:
+      - The current template on the left.
+      - A selection for a different template and version on the right.
 
-      - On the left, your current template is shown.
-      - On the right, you can select a different template and version.
-   
-   Initially, both templates are the same. 
+   Initially, both templates will be the same. 
 
-7. On the right, select a different template or version:
-   
-   - **Template**: Change to a different template entirely
-   - **Version**: Change to a different version of the template you selected
+7. Select a different template or version on the right:
 
-   For example: Select a previous version of the template currently in use to revert to that version. 
+   - **Template**: To change the template entirely.
+   - **Version**: To switch to a different version of the selected template.
 
-   After you select a different template or version, the YAML differences between the templates are highlighted. 
+   Differences in YAML between the templates will be highlighted after selection. 
 
 8. Click **Prepare Swap**.
 
-9. Enter a note to enable completing the swap and click **Swap Template**.
+9. Enter a note for the swap and click **Swap Template**.
 
-After your model documentation template has been swapped successfully, you can continue to work on your model documentation or validation report.
+After successfully swapping the model documentation template, you can proceed with your documentation or validation report work.
 
 ::: {.callout-tip}
 ## Is there any content missing from the new template?
-If you added a simple text block to your old template and want to reuse the content, you can temporarily switch back to the old template, copy the content, swap back to the new template, and then paste in the content.
+If you want to reuse content from a text block added to the old template, switch back to the old template temporarily, copy the content, swap to the new template again, and paste the content.
 :::
 
 <!---
@@ -82,4 +78,4 @@ If you added a simple text block to your old template and want to reuse the cont
 ## What's next
 
 - [Get started with the ValidMind Developer Framework](get-started-developer-framework.qmd)
---->
+--->