Merge pull request #51819 from michellengnx/KEP-3962

[KEP-3962]Update the status of the MutatingAdmissionPolicy

Author: k8s-ci-robot

content/en/docs/reference/access-authn-authz/mutating-admission-policy.md

@@ -9,10 +9,17 @@ content_type: concept
 
 <!-- overview -->
 
-{{< feature-state for_k8s_version="v1.32" state="alpha" >}}
+{{< feature-state for_k8s_version="v1.34" state="beta" >}}
 <!-- due to feature gate history, use manual version specification here -->
 
 This page provides an overview of _MutatingAdmissionPolicies_.
+MutatingAdmissionPolicies allow you change what happens when someone writes a change to the Kubernetes API.
+If you want to use declarative policies just to prevent a particular kind of change to resources (for example: protecting platform namespaces from deletion),
+[ValidatingAdmissionPolicy](/docs/reference/access-authn-authz/validating-admission-policy/)
+is
+a simpler and more effective alternative.
+
+To use the feature, enable the `MutatingAdmissionPolicy` feature gate (which is off by default) and set `--runtime-config=admissionregistration.k8s.io/v1beta1=true` on the kube-apiserver.
 
 <!-- body -->
 

content/en/docs/reference/command-line-tools-reference/feature-gates/MutatingAdmissionPolicy.md

@@ -9,8 +9,14 @@ stages:
   - stage: alpha 
     defaultValue: false
     fromVersion: "1.30"
+    toVersion: "1.33"
+  - stage: beta
+    defaultValue: false
+    fromVersion: "1.34"
 ---
 
-Enable [MutatingAdmissionPolicy](/docs/reference/access-authn-authz/mutating-admission-policy/) support for [CEL](https://kubernetes.io/docs/reference/using-api/cel/) mutations be used in admission control.
+Enable [MutatingAdmissionPolicy](/docs/reference/access-authn-authz/mutating-admission-policy/) support, which allows
+[CEL](/docs/reference/using-api/cel/) mutations to
+be applied during admission control.
 
 For Kubernetes v1.30 and v1.31, this feature gate existed but had no effect.

content/en/examples/mutatingadmissionpolicy/applyconfiguration-example.yaml

@@ -1,4 +1,4 @@
-apiVersion: admissionregistration.k8s.io/v1alpha1
+apiVersion: admissionregistration.k8s.io/v1beta1
 kind: MutatingAdmissionPolicy
 metadata:
   name: "sidecar-policy.example.com"

content/en/examples/mutatingadmissionpolicy/json-patch-example.yaml

@@ -1,4 +1,4 @@
-apiVersion: admissionregistration.k8s.io/v1alpha1
+apiVersion: admissionregistration.k8s.io/v1beta1
 kind: MutatingAdmissionPolicy
 metadata:
   name: "sidecar-policy.example.com"