move content to partial and active voice rewrites

lane-wetmore · lane-wetmore · commit cfcb6e198d6e · 2025-10-20T14:26:53.000-05:00
diff --git a/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/replicated-cluster.mdx b/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/replicated-cluster.mdx
@@ -36,34 +36,9 @@ Load the snapshot holding the secret you want to recover:
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
+<Tab heading="GUI" group="gui">
 
-1. Open a web browser to access the Vault UI and sign in to the root namespace.
-   <Tip title="Namespace restriction">
-
-   Snapshot load and unload operations are restricted to the root namespace. All other snapshot operations 
-   can be performed in other namespaces. 
-
-    </Tip>
-
-    <Tip title="Permissions Required">
-        This requires snapshot management permissions.
-    </Tip>
-
-2. Select **Secrets Recovery** from the left navigation menu.
-
-3. Select **Upload snapshot**.
-    ![Load snapshot button location emphasized](/img/ui-secret-recovery-upload.png)
-
-4. Select the method of upload. If loading from **automated** snapshots, an automated snapshot config is required.
-Refer to the [automated snapshot API](https://developer.hashicorp.com/vault/api-docs/system/storage/raftautosnapshots#load-a-snapshot-from-an-automated-snapshot-configuration) 
-to learn more about automated snapshots.
-    ![Load snapshot form](/img/ui-secret-recovery-upload-form.png)
-
-5. Click **Load snapshot** to complete the upload.
-6. The status of the snapshot and the expiration date is shown. This also allows 
-navigation to the snapshot details view.
-    ![Snapshot overview card with status and details link emphasized](/img/ui-secret-recovery-overview-details.png)
+@include 'sysadmin/snapshots/load-snapshot/gui/gui.mdx'
 
 </Tab>
 
@@ -135,12 +110,9 @@ You can check for a loaded snapshot by listing the loaded snapshots:
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
+<Tab heading="GUI" group="gui">
 
-1. Select **Secrets Recovery** from the left navigation menu.
-
-2. If a snapshot has been loaded, it will appear here.
-    ![Loaded snapshot card emphasized](/img/ui-secret-recovery-loaded-snapshot.png)
+@include 'sysadmin/snapshots/list-snapshots/gui.mdx'
 
 </Tab>
 
@@ -170,20 +142,9 @@ storage.
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
-    <Tip title="Permissions Required">
-        This requires read and/or recover permissions specific to the resource.
-    </Tip>
-
-1. A namespace selector will show when in the root namespace. Fill in the available fields to locate the secret to read or recover.
-    ![Snapshot read and recover form fields](/img/ui-secret-recovery-fields.png)
+<Tab heading="GUI" group="gui">
 
-2. Upon a successful read operation, the resource can be viewed as key value pairs or as JSON.
-    ![Snapshot read view in key value format](/img/ui-secret-recovery-read-kv.png)
-    ![Snapshot read view in JSON format](/img/ui-secret-recovery-read-json.png)
-    
-3. In addition to recovering to the original resource path, recovering a copy to a new path is possible. The original resource will be unaffected.
-    ![Snapshot recovery to copy operation](/img/ui-secret-recovery-recover-copy.png)
+@include 'sysadmin/snapshots/secret-restore/recover/gui.mdx'
 
 </Tab>
 
@@ -207,13 +168,9 @@ storage.
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
-    <Tip title="Permissions Required">
-        This requires recover permissions specific to the resource.
-    </Tip>
+<Tab heading="GUI" group="gui">
 
-Upon a successful recovery operation, a success message with a link to the recovered resource will be shown.
-    ![Snapshot recovery operation](/img/ui-secret-recovery-recover-message.png)
+@include 'sysadmin/snapshots/secret-restore/verify/gui.mdx'
 
 </Tab>
 
diff --git a/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/single-cluster.mdx b/content/vault/v1.21.x (rc)/content/docs/sysadmin/snapshots/recover-a-secret/single-cluster.mdx
@@ -31,34 +31,9 @@ Load the snapshot holding the secret you want to recover.
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
+<Tab heading="GUI" group="gui">
 
-1. Open a web browser to access the Vault UI and sign in to the root namespace.
-   <Tip title="Namespace restriction">
-
-   Snapshot load and unload operations are restricted to the root namespace. All other snapshot operations 
-   can be performed in other namespaces. 
-
-    </Tip>
-
-    <Tip title="Permissions Required">
-        This requires snapshot management permissions.
-    </Tip>
-
-2. Select **Secrets Recovery** from the left navigation menu.
-
-3. Select **Upload snapshot**.
-    ![Load snapshot button location emphasized](/img/ui-secret-recovery-upload.png)
-
-4. Select the method of upload. If loading from **automated** snapshots, an automated snapshot config is required.
-Refer to the [automated snapshot API](https://developer.hashicorp.com/vault/api-docs/system/storage/raftautosnapshots#load-a-snapshot-from-an-automated-snapshot-configuration) 
-to learn more about automated snapshots.
-    ![Load snapshot form](/img/ui-secret-recovery-upload-form.png)
-
-5. Click **Load snapshot** to complete the upload.
-6. The status of the snapshot and the expiration date is shown. This also allows 
-navigation to the snapshot details view.
-    ![Snapshot overview card with status and details link emphasized](/img/ui-secret-recovery-overview-details.png)
+@include 'sysadmin/snapshots/load-snapshot/gui/gui.mdx'
 
 </Tab>
 
@@ -131,12 +106,9 @@ You can check for a loaded snapshot by listing the loaded snapshots:
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
-
-1. Select **Secrets Recovery** from the left navigation menu.
+<Tab heading="GUI" group="gui">
 
-2. If a snapshot has been loaded, it will appear here.
-    ![Loaded snapshot card emphasized](/img/ui-secret-recovery-loaded-snapshot.png)
+@include 'sysadmin/snapshots/list-snapshots/gui.mdx'
 
 </Tab>
     
@@ -166,20 +138,9 @@ storage.
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
-    <Tip title="Permissions Required">
-        This requires read and/or recover permissions specific to the resource.
-    </Tip>
+<Tab heading="GUI" group="gui">
 
-1. A namespace selector will show when in the root namespace. Fill in the available fields to locate the secret to read or recover.
-    ![Snapshot read and recover form fields](/img/ui-secret-recovery-fields.png)
-
-2. Upon a successful read operation, the resource can be viewed as key value pairs or as JSON.
-    ![Snapshot read view in key value format](/img/ui-secret-recovery-read-kv.png)
-    ![Snapshot read view in JSON format](/img/ui-secret-recovery-read-json.png)
-    
-3. In addition to recovering to the original resource path, recovering a copy to a new path is possible. The original resource will be unaffected.
-    ![Snapshot recovery to copy operation](/img/ui-secret-recovery-recover-copy.png)
+@include 'sysadmin/snapshots/secret-restore/recover/gui.mdx'
 
 </Tab>
 
@@ -203,13 +164,9 @@ storage.
 
 <Tabs>
 
-<Tab heading="Web UI" group="ui">
-    <Tip title="Permissions Required">
-        This requires recover permissions specific to the resource.
-    </Tip>
+<Tab heading="GUI" group="gui">
 
-Upon a successful recovery operation, a success message with a link to the recovered resource will be shown.
-    ![Snapshot recovery operation](/img/ui-secret-recovery-recover-message.png)
+@include 'sysadmin/snapshots/secret-restore/verify/gui.mdx'
 
 </Tab>
 
diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/list-snapshots/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/list-snapshots/gui.mdx
@@ -0,0 +1,3 @@
+![Loaded snapshot card emphasized](/img/ui-secret-recovery-loaded-snapshot.png)
+	
+Select **Secrets Recovery** from the navigation menu to view currently loaded snapshots.
diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/load-snapshot/gui/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/load-snapshot/gui/gui.mdx
@@ -0,0 +1,23 @@
+Snapshot load and unload operations are restricted to the root namespace. All other snapshot operations 
+	can be performed in other namespaces. 
+
+1. Open the Vault GUI and sign in to the root namespace. While you can perform
+other snapshot operations from any namespace, you must perform load and
+	   unload operations under the `root` namespace.
+
+1. Select **Secrets Recovery** from the left navigation menu.
+
+1. Select **Upload snapshot**.
+    ![Load snapshot button location emphasized](/img/ui-secret-recovery-upload.png)
+
+1. Select your upload method. To use an automated snapshot you must provide an
+	   [automated snapshot config](/vault/api-docs/system/storage/raftautosnapshots#load-a-snapshot-from-an-automated-snapshot-configuration).
+    ![Load snapshot form](/img/ui-secret-recovery-upload-form.png)
+
+1. Click **Load snapshot** to complete the upload.
+
+1. Monitor the upload until the status says "Ready" and the expiration date
+	   populates.
+    ![Snapshot overview card with status and details link emphasized](/img/ui-secret-recovery-overview-details.png)
+
+1. Click "View details &rarr; to open the snapshot details view
diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/recover/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/recover/gui.mdx
@@ -0,0 +1,8 @@
+![Snapshot read and recover form fields](/img/ui-secret-recovery-fields.png)
+	
+Use the available selectors and input fields to find the secret you want to read or recover. Once
+you selected, you can:
+	
+- view the snapshot data as key/value pairs or as a JSON object
+- recover to the original resource path
+- recover the original resource to a new path
diff --git a/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/verify/gui.mdx b/content/vault/v1.21.x (rc)/content/partials/sysadmin/snapshots/secret-restore/verify/gui.mdx
@@ -0,0 +1,3 @@
+If the recovery operation succeeds, the GUI displays a success message with a
+link to the recovered resource.
+![Snapshot recovery operation](/img/ui-secret-recovery-recover-message.png)

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+![Loaded snapshot card emphasized](/img/ui-secret-recovery-loaded-snapshot.png)`
	`2`	`+`
	`3`	`+Select Secrets Recovery from the navigation menu to view currently loaded snapshots.`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,3 @@`
	`1`	`+If the recovery operation succeeds, the GUI displays a success message with a`
	`2`	`+link to the recovered resource.`
	`3`	`+![Snapshot recovery operation](/img/ui-secret-recovery-recover-message.png)`