From 7ab90b47f3f97db305120feca7052cff8cf23f37 Mon Sep 17 00:00:00 2001
From: Yan Bondarenko <202671653+yankawai@users.noreply.github.com>
Date: Sat, 26 Sep 2026 02:23:30 +0300
Subject: [PATCH] docs(platform-package): document kubevirt.migrations for v1.6

cozystack/cozystack#4402 backports the kubevirt.migrations platform value
to the 1.6 line, and the v1.6 reference had no KubeVirt section at all.
This adds the migrations row and its example from the next page, with a
line saying the value is available since v1.6.4, because earlier 1.6
releases ignore it. The disabledFeatureGates row stays out, as that value
is not on the 1.6 line.

Signed-off-by: Yan Bondarenko <202671653+yankawai@users.noreply.github.com>
---
 .../configuration/platform-package.md         | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/content/en/docs/v1.6/operations/configuration/platform-package.md b/content/en/docs/v1.6/operations/configuration/platform-package.md
index 1918d05e..ddf165d5 100644
--- a/content/en/docs/v1.6/operations/configuration/platform-package.md
+++ b/content/en/docs/v1.6/operations/configuration/platform-package.md
@@ -200,6 +200,26 @@ registries:
 | `resources.memoryAllocationRatio` | `1` | Memory allocation ratio: `1/memoryAllocationRatio` memory requested per unit of configured memory. |
 | `resources.ephemeralStorageAllocationRatio` | `40` | Ephemeral storage allocation ratio: `1/ephemeralStorageAllocationRatio` ephemeral storage requested per unit of configured storage. |
 
+#### KubeVirt
+
+`kubevirt.migrations` is available since Cozystack v1.6.4. Earlier 1.6 releases ignore it.
+
+| Value | Default | Description |
+| --- | --- | --- |
+| `kubevirt.migrations` | `{}` | Cluster-wide settings forwarded to `spec.configuration.migrations` on the KubeVirt CR. Set them through the platform Package so they are part of the rendered configuration. An empty or null map leaves KubeVirt's defaults unchanged. |
+
+Example under `spec.components.platform.values`:
+
+```yaml
+kubevirt:
+  migrations:
+    bandwidthPerMigration: 625M
+    parallelMigrationsPerCluster: 2
+    parallelOutboundMigrationsPerNode: 1
+```
+
+`bandwidthPerMigration` is a quantity in bytes per second, so `625M` is 625,000,000 bytes/s (5 Gbit/s) per migration. This example allows up to two migrations across the cluster and one outbound migration per node.
+
 #### Internal fields
 
 These fields are managed automatically by the Cozystack operator and should not be modified manually.