More feedback

Author: fabriziopandini

docs/proposals/20220414-lifecycle-hooks.md

@@ -164,6 +164,9 @@ workersUpgrades:
   - version: v1.33.0
 ```
 
+Note: The `controlPlaneUpgrades` and the `workersUpgrades` fields contains the intermediate steps to reach the target version,
+which is also included in the list.
+
 ####  BeforeControlPlaneUpgrade (new hook)
 
 This hook is called before a new version is propagated to the control plane object. Runtime Extension implementers
@@ -201,7 +204,8 @@ workersUpgrades:
   - version: v1.33.0
 ```
 
-Note: The upgrade plan in the request contains only missing steps to reach the target version.
+Note: The `controlPlaneUpgrades` and the `workersUpgrades` fields contains the intermediate steps to reach the target version,
+which is also included in the list.
 
 ##### Example Response:
 
@@ -255,7 +259,8 @@ workersUpgrades:
   - version: v1.33.0
 ```
 
-Note: The upgrade plan in the request contains only missing steps to reach the target version, if any.
+Note: The `controlPlaneUpgrades` and the `workersUpgrades` fields contains the intermediate steps to reach the target version,
+which is also included in the list.
 
 ##### Example Response:
 
@@ -303,7 +308,8 @@ workersUpgrades:
   - version: v1.33.0
 ```
 
-Note: The upgrade plan in the request contains only missing steps to reach the target version.
+Note: The `controlPlaneUpgrades` and the `workersUpgrades` fields contains the intermediate steps to reach the target version,
+which is also included in the list.
 
 ##### Example Response:
 
@@ -350,7 +356,8 @@ workersUpgrades:
   - version: v1.33.0
 ```
 
-Note: The upgrade plan in the request contains only missing steps to reach the target version, if any.
+Note: The `controlPlaneUpgrades` and the `workersUpgrades` fields contains the intermediate steps to reach the target version,
+which is also included in the list.
 
 ##### Example Response:
 

docs/proposals/20250513-chained-and-efficient-upgrades-for-clusters-with-managed-topologies.md

@@ -247,8 +247,11 @@ consistent with `controlPlaneUpgrades` and also compliant with the [Kubernetes v
   - version: v1.31.0
   - version: v1.32.3
   ```
-  
-Please note:
+
+Note: in this case the system will take into consideration the provided `workersUpgrades`, and validated it is
+consistent with `controlPlaneUpgrades` and also compliant with the [Kubernetes version skew policy](https://kubernetes.io/releases/version-skew-policy/).
+
+Plase also consider that:
 - In case both the list of Kubernetes versions and the runtime extension definition will be left empty in a cluster class, 
   Cluster API will behave as of today: only upgrades to the next minor are allowed for the corresponding clusters.
 - If the list of Kubernetes versions is defined in a ClusterClass, the system is going to use this info also in