Fix review findings

sbueringer · sbueringer · commit 9e4d665a390e · 2025-05-26T13:02:22.000+02:00
diff --git a/docs/book/src/developer/providers/migrations/v1.10-to-v1.11.md b/docs/book/src/developer/providers/migrations/v1.10-to-v1.11.md
@@ -129,6 +129,7 @@ proposal because most of the changes described below are a consequence of the wo
   - The const values for `Failed` phase has been deprecated in the enum type for `status.phase` (controllers are not setting this value anymore)
 - The `status.phases` field is now computed using the same logic used for `ScalingUp` and `ScalingDown` conditions.
 - The `spec.revisionHistoryLimit` field has been removed. The MachineDeployment controller will now clean up all MachineSets without replicas.
+  - The corresponding `machinedeployment.clusters.x-k8s.io/revision-history` annotation has also been removed.
  
 ### MachineSet
 
diff --git a/docs/book/src/reference/api/labels-and-annotations.md b/docs/book/src/reference/api/labels-and-annotations.md
@@ -52,7 +52,6 @@
 | machinedeployment.clusters.x-k8s.io/desired-replicas             | It is the desired replicas for a machine deployment recorded as an annotation in its machine sets. Helps in separating scaling events from the rollout process and for determining if the new machine set for a deployment is really saturated.                                                                                                                                                                                                                                                                                                             | Cluster API              | MachineSets                                    |
 | machinedeployment.clusters.x-k8s.io/max-replicas                 | It is the maximum replicas a deployment can have at a given point, which is machinedeployment.spec.replicas + maxSurge. Used by the underlying machine sets to estimate their proportions in case the deployment has surge replicas.                                                                                                                                                                                                                                                                                                                        | Cluster API              | MachineSets                                    |
 | machinedeployment.clusters.x-k8s.io/revision                     | It is the revision annotation of a machine deployment's machine sets which records its rollout sequence.                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Cluster API              | MachineSets                                    |
-| machinedeployment.clusters.x-k8s.io/revision-history             | It maintains the history of all old revisions that a machine set has served for a machine deployment.                                                                                                                                                                                                                                                                                                                                                                                                                                                       | Cluster API              | MachineSets                                    |
 | machineset.cluster.x-k8s.io/skip-preflight-checks                | It can be applied on MachineDeployment and MachineSet resources to specify a comma-separated list of preflight checks that should be skipped during MachineSet reconciliation. Supported preflight checks are: All, KubeadmVersionSkew, KubernetesVersionSkew, ControlPlaneIsStable.                                                                                                                                                                                                                                                                        | User                     | MachineDeployments, MachineSets                |
 | pre-drain.delete.hook.machine.cluster.x-k8s.io                   | It specifies the prefix we search each annotation for during the pre-drain.delete lifecycle hook to pause reconciliation of deletion. These hooks will prevent removal of draining the associated node until all are removed.                                                                                                                                                                                                                                                                                                                               | User                     | Machines                                       |
 | pre-terminate.delete.hook.machine.cluster.x-k8s.io               | It specifies the prefix we search each annotation for during the pre-terminate.delete lifecycle hook to pause reconciliation of deletion. These hooks will prevent removal of an instance from an infrastructure provider until all are removed.                                                                                                                                                                                                                                                                                                            | User                     | Machines                                       |
