From 73fdf3e0b8cccb59516c983319204df97c5909f1 Mon Sep 17 00:00:00 2001
From: Your Name <lalitchauhan@google.com>
Date: Tue, 17 Feb 2026 23:10:02 +0000
Subject: [PATCH] Docs placeholder for KEP 3962: Mutating Admission Policies
 (Stable v1.36)

---
 .../access-authn-authz/mutating-admission-policy.md       | 4 ++--
 .../feature-gates/MutatingAdmissionPolicy.md              | 8 ++++++--
 .../applyconfiguration-example.yaml                       | 2 +-
 .../mutatingadmissionpolicy/json-patch-example.yaml       | 2 +-
 4 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/content/en/docs/reference/access-authn-authz/mutating-admission-policy.md b/content/en/docs/reference/access-authn-authz/mutating-admission-policy.md
index f5f3dd22ae8..bf1bdc92614 100644
--- a/content/en/docs/reference/access-authn-authz/mutating-admission-policy.md
+++ b/content/en/docs/reference/access-authn-authz/mutating-admission-policy.md
@@ -9,7 +9,7 @@ content_type: concept
 
 <!-- overview -->
 
-{{< feature-state for_k8s_version="v1.34" state="beta" >}}
+{{< feature-state feature_gate_name="MutatingAdmissionPolicy" >}}
 <!-- due to feature gate history, use manual version specification here -->
 
 This page provides an overview of _MutatingAdmissionPolicies_.
@@ -19,7 +19,7 @@ If you want to use declarative policies just to prevent a particular kind of cha
 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 -->
 
diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates/MutatingAdmissionPolicy.md b/content/en/docs/reference/command-line-tools-reference/feature-gates/MutatingAdmissionPolicy.md
index f99a28a32f3..4ed3821690d 100644
--- a/content/en/docs/reference/command-line-tools-reference/feature-gates/MutatingAdmissionPolicy.md
+++ b/content/en/docs/reference/command-line-tools-reference/feature-gates/MutatingAdmissionPolicy.md
@@ -6,17 +6,21 @@ _build:
   render: false
 
 stages:
-  - stage: alpha 
+  - stage: alpha
     defaultValue: false
     fromVersion: "1.30"
     toVersion: "1.33"
   - stage: beta
     defaultValue: false
     fromVersion: "1.34"
+    toVersion: "1.35"
+  - stage: stable
+    defaultValue: true
+    fromVersion: "1.36"
 ---
 
 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.
\ No newline at end of file
+For Kubernetes v1.30 and v1.31, this feature gate existed but had no effect.
diff --git a/content/en/examples/mutatingadmissionpolicy/applyconfiguration-example.yaml b/content/en/examples/mutatingadmissionpolicy/applyconfiguration-example.yaml
index 19439f6adaf..18711f2aabf 100644
--- a/content/en/examples/mutatingadmissionpolicy/applyconfiguration-example.yaml
+++ b/content/en/examples/mutatingadmissionpolicy/applyconfiguration-example.yaml
@@ -1,4 +1,4 @@
-apiVersion: admissionregistration.k8s.io/v1beta1
+apiVersion: admissionregistration.k8s.io/v1
 kind: MutatingAdmissionPolicy
 metadata:
   name: "sidecar-policy.example.com"
diff --git a/content/en/examples/mutatingadmissionpolicy/json-patch-example.yaml b/content/en/examples/mutatingadmissionpolicy/json-patch-example.yaml
index 0caedd94a5f..e2b2c2b530b 100644
--- a/content/en/examples/mutatingadmissionpolicy/json-patch-example.yaml
+++ b/content/en/examples/mutatingadmissionpolicy/json-patch-example.yaml
@@ -1,4 +1,4 @@
-apiVersion: admissionregistration.k8s.io/v1beta1
+apiVersion: admissionregistration.k8s.io/v1
 kind: MutatingAdmissionPolicy
 metadata:
   name: "sidecar-policy.example.com"