[KEP-5440] Add documentation for mutable pod resources while job is suspended

content/en/docs/concepts/workloads/controllers/job.md

@@ -977,6 +977,17 @@ been unsuspended before.
 The fields in a Job's pod template that can be updated are node affinity, node selector,
 tolerations, labels, annotations and [scheduling gates](/docs/concepts/scheduling-eviction/pod-scheduling-readiness/).
 
+### Mutable Pod resources for suspended Jobs
+
+{{< feature-state feature_gate_name="MutablePodResourcesForSuspendedJobs" >}}
+
+A cluster administrator can define admission controls in Kubernetes, modifying the resource requests or limits for a Job, based on policy rules.
+
+As an alpha feature, Kubernetes also lets you modify the Pod template of an existing Job that hasn't yet started, to change the resource requirements of the Pods in the Job.
+This is different from _in-place Pod resize_ which lets you update resources, one Pod at a time, for Pods that are already running.
+
+The client that sets the new resource requests or limits can be different from the client that initially created the Job, and does not need to be a cluster administrator.
+
 ### Specifying your own Pod selector
 
 Normally, when you create a Job object, you do not specify `.spec.selector`.

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

@@ -0,0 +1,16 @@
+---
+title: MutablePodResourcesForSuspendedJobs 
+content_type: feature_gate
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: alpha 
+    defaultValue: false
+    fromVersion: "1.35"
+    toVersion: "1.35"
+removed: false
+---
+Enable the ability to patch pod templates for suspended Jobs, in order to change requests or limits for infrastructure resources.
+