Add missing information to v1.5.2 upgrade documentation (#895)

jillian-maroket · web-flow · commit b2d7ea7ce332 · 2025-10-09T10:31:16.000+08:00
* Add v1.5.2 to upgrade paths table
Signed-off-by: Jillian &lt;jillian.maroket@suse.com&gt;

* Add note about upgrading to v1.5.2
Signed-off-by: Jillian &lt;jillian.maroket@suse.com&gt;

* Add link to Upgrade paths section
Signed-off-by: Jillian &lt;jillian.maroket@suse.com&gt;

* Update component versions table
Signed-off-by: Jillian &lt;jillian.maroket@suse.com&gt;

* Fix broken link in Upgrade paths table
Signed-off-by: Jillian &lt;jillian.maroket@suse.com&gt;

---------
Signed-off-by: Jillian &lt;jillian.maroket@suse.com&gt;
diff --git a/docs/upgrade/automatic.md b/docs/upgrade/automatic.md
@@ -34,7 +34,7 @@ The following table outlines the supported upgrade paths.
 
 | Installed Version | Supported Upgrade Versions |
 | --- | --- |
-| v1.5.0/v1.5.1 | [v1.6.0](./v1-5-0-to-v1-6-0.md) |
+| v1.5.0/v1.5.1/v1.5.2 | [v1.6.0](./v1-5-x-to-v1-6-0.md) |
 | v1.5.0 | [v1.5.1](./v1-5-0-to-v1-5-1.md) |
 | v1.4.2/v1.4.3 | [v1.5.0](./v1-4-2-to-v1-5-0.md) and [v1.5.1](./v1-4-2-to-v1-5-1.md) |
 | v1.4.1/v1.4.2 | [v1.4.3](./v1-4-1-to-v1-4-3.md) |
@@ -53,12 +53,12 @@ Harvester v1.5.x and later versions allow the following:
 
 The following table outlines the components used in these versions:
 
-| Components | Harvester v1.4.2 and v1.4.3 | Harvester v1.5.x |
+| Components | Harvester v1.5.x | Harvester v1.6.0 |
 | --- | --- | --- |
-| KubeVirt | v1.3 | v1.4 |
-| Longhorn | v1.7 | v1.8 |
-| Rancher | v2.10 | v2.11 |
-| RKE2 | v1.31 | v1.32 |
+| KubeVirt | v1.4 | v1.5.2 |
+| Longhorn | v1.8 | v1.9.1 |
+| Rancher | v2.11 | v2.12.0 |
+| RKE2 | v1.32 | v1.33.3 |
 
 :::note
 
diff --git a/docs/upgrade/v1-5-x-to-v1-6-0.md b/docs/upgrade/v1-5-x-to-v1-6-0.md
@@ -12,7 +12,13 @@ title: "Upgrade from v1.5.x to v1.6.0"
 
 An **Upgrade** button appears on the **Dashboard** screen whenever a new Harvester version that you can upgrade to becomes available. For more information, see [Start an upgrade](./automatic.md#start-an-upgrade).
 
-You can directly upgrade from v1.5.0 to v1.6.0 because Harvester allows a maximum of one minor version upgrade for underlying components. Harvester v1.5.0, v1.5.1, and v1.5.2 use the same minor version of RKE2 (v1.32), while Harvester v1.6.0 uses the next minor version (v1.33).
+Clusters running v1.5.0 and v1.5.1 can upgrade to v1.6.x directly because Harvester allows a maximum of one minor version upgrade for underlying components. Harvester v1.5.0, v1.5.1, and v1.5.2 use the same minor version of RKE2 (v1.32), while Harvester v1.6.0 uses the next minor version (v1.33). For more information, see [Upgrade paths](./automatic.md#upgrade-paths).
+
+:::note
+
+Only customers affected by issues listed in the Bug Fixes section of the [release notes](https://github.com/harvester/harvester/releases/tag/v1.5.2) must install v1.5.2.
+
+:::
 
 For information about upgrading Harvester in air-gapped environments, see [Prepare an air-gapped upgrade](./automatic.md#prepare-an-air-gapped-upgrade).
 
diff --git a/versioned_docs/version-v1.6/upgrade/automatic.md b/versioned_docs/version-v1.6/upgrade/automatic.md
@@ -34,7 +34,7 @@ The following table outlines the supported upgrade paths.
 
 | Installed Version | Supported Upgrade Versions |
 | --- | --- |
-| v1.5.0/v1.5.1 | [v1.6.0](./v1-5-0-to-v1-6-0.md) |
+| v1.5.0/v1.5.1/v1.5.2 | [v1.6.0](./v1-5-x-to-v1-6-0.md) |
 | v1.5.0 | [v1.5.1](./v1-5-0-to-v1-5-1.md) |
 | v1.4.2/v1.4.3 | [v1.5.0](./v1-4-2-to-v1-5-0.md) and [v1.5.1](./v1-4-2-to-v1-5-1.md) |
 | v1.4.1/v1.4.2 | [v1.4.3](./v1-4-1-to-v1-4-3.md) |
@@ -53,12 +53,12 @@ Harvester v1.5.x and later versions allow the following:
 
 The following table outlines the components used in these versions:
 
-| Components | Harvester v1.4.2 and v1.4.3 | Harvester v1.5.x |
+| Components | Harvester v1.5.x | Harvester v1.6.0 |
 | --- | --- | --- |
-| KubeVirt | v1.3 | v1.4 |
-| Longhorn | v1.7 | v1.8 |
-| Rancher | v2.10 | v2.11 |
-| RKE2 | v1.31 | v1.32 |
+| KubeVirt | v1.4 | v1.5.2 |
+| Longhorn | v1.8 | v1.9.1 |
+| Rancher | v2.11 | v2.12.0 |
+| RKE2 | v1.32 | v1.33.3 |
 
 :::note
 
diff --git a/versioned_docs/version-v1.6/upgrade/v1-5-x-to-v1-6-0.md b/versioned_docs/version-v1.6/upgrade/v1-5-x-to-v1-6-0.md
@@ -12,7 +12,13 @@ title: "Upgrade from v1.5.x to v1.6.0"
 
 An **Upgrade** button appears on the **Dashboard** screen whenever a new Harvester version that you can upgrade to becomes available. For more information, see [Start an upgrade](./automatic.md#start-an-upgrade).
 
-You can directly upgrade from v1.5.0 to v1.6.0 because Harvester allows a maximum of one minor version upgrade for underlying components. Harvester v1.5.0, v1.5.1, and v1.5.2 use the same minor version of RKE2 (v1.32), while Harvester v1.6.0 uses the next minor version (v1.33).
+Clusters running v1.5.0 and v1.5.1 can upgrade to v1.6.x directly because Harvester allows a maximum of one minor version upgrade for underlying components. Harvester v1.5.0, v1.5.1, and v1.5.2 use the same minor version of RKE2 (v1.32), while Harvester v1.6.0 uses the next minor version (v1.33). For more information, see [Upgrade paths](./automatic.md#upgrade-paths).
+
+:::note
+
+Only customers affected by issues listed in the Bug Fixes section of the [release notes](https://github.com/harvester/harvester/releases/tag/v1.5.2) must install v1.5.2.
+
+:::
 
 For information about upgrading Harvester in air-gapped environments, see [Prepare an air-gapped upgrade](./automatic.md#prepare-an-air-gapped-upgrade).
 
