diff --git a/content/en/hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md b/content/en/hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md
index 7fb034839..37241c2f3 100644
--- a/content/en/hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md
+++ b/content/en/hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md
@@ -19,9 +19,11 @@ docker compose up
 ```
 
 ## Set Up Environment Variables
+
+Be sure to replace both `<admin-user>` and `<password>` with your actual username and password.  As well, update `<couchdb-host>` to the CouchDB URL from the Docker Compose setup:
+
 ```shell
-# Replace with your actual CouchDB URL from the Docker Compose setup
-export COUCH_URL=http://<your-admin-user>:<your-admin-password>@<couchdb-host>:5984
+export COUCH_URL=http://<admin-user>:<password>@<couchdb-host>:5984
 ```
 
 ## Run Pre-Migration Commands
diff --git a/content/en/hosting/4.x/_partial_values_explanation.md b/content/en/hosting/4.x/_partial_values_explanation.md
index 2bbc83c01..6f5d25777 100644
--- a/content/en/hosting/4.x/_partial_values_explanation.md
+++ b/content/en/hosting/4.x/_partial_values_explanation.md
@@ -3,10 +3,13 @@ toc_hide: true
 hide_summary: true
 ---
 
+Be sure to update the following values in your YAML file:
+
 * `<your-namespace>` (_two occurrences_)
 * `<version>` - 4.x version you're upgrading to
 * `<password>` - retrieved from `get-env` call above
 * `<secret>` - retrieved from `get-env` call above
 * `<admin_user>` - needs to be the same as used in 3.x - likely `medic`
 * `<uuid>` - retrieved from `get-env` call above
-* `<url>` - your DNS goes here (your-dns-address.org)
+* `<url>` - the URL of your production instance goes here (eg `example.org`)
+* `<path-to-tls>` - path to TLS files on disk
diff --git a/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-multi.md b/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-multi.md
index 3ec2acfc2..92d4d2db8 100644
--- a/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-multi.md
+++ b/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-multi.md
@@ -6,7 +6,7 @@ description: >
   Guide to migrate existing data from CHT 3.x Docker Compose deployment to CHT 4.x clustered K3s deployment with 3 CouchDB nodes
 relatedContent: >
 ---
-{{ < read-content file="hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md"  }}
+{{< read-content file="hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md"  >}}
 
 # Create directories on secondary nodes
 
@@ -16,11 +16,11 @@ ssh <user>@<node3-hostname> "sudo mkdir -p /srv/couchdb3/data/shards /srv/couchd
 ```
 
 ## Create values.yaml for K3s Deployment
-{{ < read-content file="hosting/4.x/_partial_values_explanation.md"  }}
+{{< read-content file="hosting/4.x/_partial_values_explanation.md"  >}}
 
 ```yaml
-project_name: "your-namespace"
-namespace: "your-namespace"
+project_name: "<your-namespace>"
+namespace: "<your-namespace>"
 chtversion: <version>
 
 upstream_servers:
diff --git a/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-single.md b/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-single.md
index 8b4e76ef6..e42ca8406 100644
--- a/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-single.md
+++ b/content/en/hosting/4.x/data-migration-3x-docker-to-4x-k3s-single.md
@@ -6,14 +6,14 @@ description: >
   Guide on how to migrate existing data from CHT 3.x Docker Compose deployment to CHT 4.x single-node K3s deployment
 relatedContent: >
 ---
-{{ < read-content file="hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md"  }}
+{{< read-content file="hosting/4.x/_partial_migration_3x_docker_to_4x_k3s.md"  >}}
 
 ## Create values.yaml for K3s Deployment
-{{ < read-content file="hosting/4.x/_partial_values_explanation.md"  }}
+{{< read-content file="hosting/4.x/_partial_values_explanation.md"  >}}
 
 ```yaml
-project_name: "your-namespace"
-namespace: "your-namespace"
+project_name: "<your-namespace>"
+namespace: "<your-namespace>"
 chtversion: <version>
 
 upstream_servers: