Merge pull request #27732 from liggitt/1-21-deprecations

1.25 deprecations

Author: k8s-ci-robot

content/en/docs/reference/using-api/deprecation-guide.md

@@ -25,6 +25,14 @@ deprecated API versions to newer and more stable API versions.
 
 The **v1.25** release will stop serving the following deprecated API versions:
 
+#### CronJob {#cronjob-v125}
+
+The **batch/v1beta1** API version of CronJob will no longer be served in v1.25.
+
+* Migrate manifests and API clients to use the **batch/v1** API version, available since v1.21.
+* All existing persisted objects are accessible via the new API
+* No notable changes
+
 #### EndpointSlice {#endpointslice-v125}
 
 The **discovery.k8s.io/v1beta1** API version of EndpointSlice will no longer be served in v1.25.
@@ -52,13 +60,14 @@ The **events.k8s.io/v1beta1** API version of Event will no longer be served in v
     * use `reportingComponent` instead of the deprecated `source.component` field (which is renamed to `deprecatedSource.component` and not permitted in new **events.k8s.io/v1** Events)
     * use `reportingInstance` instead of the deprecated `source.host` field (which is renamed to `deprecatedSource.host` and not permitted in new **events.k8s.io/v1** Events)
 
-#### RuntimeClass {#runtimeclass-v125}
+#### PodDisruptionBudget {#poddisruptionbudget-v125}
 
-RuntimeClass in the **node.k8s.io/v1beta1** API version will no longer be served in v1.25.
+The **policy/v1beta1** API version of PodDisruptionBudget will no longer be served in v1.25.
 
-* Migrate manifests and API clients to use the **node.k8s.io/v1** API version, available since v1.20.
+* Migrate manifests and API clients to use the **policy/v1** API version, available since v1.21.
 * All existing persisted objects are accessible via the new API
-* No notable changes
+* Notable changes in **policy/v1**:
+  * an empty `spec.selector` (`{}`) written to a `policy/v1` PodDisruptionBudget selects all pods in the namespace (in `policy/v1beta1` an empty `spec.selector` selected no pods). An unset `spec.selector` selects no pods in either API version.
 
 #### PodSecurityPolicy {#psp-v125}
 
@@ -67,6 +76,14 @@ PodSecurityPolicy in the **policy/v1beta1** API version will no longer be served
 PodSecurityPolicy replacements are still under discussion, but current use can be migrated to
 [3rd-party admission webhooks](https://kubernetes.io/docs/reference/access-authn-authz/extensible-admission-controllers/) now.
 
+#### RuntimeClass {#runtimeclass-v125}
+
+RuntimeClass in the **node.k8s.io/v1beta1** API version will no longer be served in v1.25.
+
+* Migrate manifests and API clients to use the **node.k8s.io/v1** API version, available since v1.20.
+* All existing persisted objects are accessible via the new API
+* No notable changes
+
 ### v1.22
 
 The **v1.22** release will stop serving the following deprecated API versions: