From 6a03f684f183447e62d47a6dde96ba4d51baafee Mon Sep 17 00:00:00 2001
From: Michal Wozniak <michalwozniak@google.com>
Date: Thu, 15 Feb 2024 19:16:13 +0100
Subject: [PATCH] Add the information about the managedBy field

---
 .../docs/concepts/workloads/controllers/job.md  | 17 +++++++++++++++++
 ...ob-managed-by-label.md => job-managed-by.md} |  2 +-
 2 files changed, 18 insertions(+), 1 deletion(-)
 rename content/en/docs/reference/command-line-tools-reference/feature-gates/{job-managed-by-label.md => job-managed-by.md} (89%)

diff --git a/content/en/docs/concepts/workloads/controllers/job.md b/content/en/docs/concepts/workloads/controllers/job.md
index be5775973b83d..4d1bde0649102 100644
--- a/content/en/docs/concepts/workloads/controllers/job.md
+++ b/content/en/docs/concepts/workloads/controllers/job.md
@@ -1006,6 +1006,23 @@ status:
   terminating: 3 # three Pods are terminating and have not yet reached the Failed phase
 ```
 
+### Delegation of managing a Job object to external controller
+
+{{< feature-state for_k8s_version="v1.30" state="alpha" >}}
+
+This feature allows delegating reconciliation of a Job object to an external
+controller. Jobs with a custom value of the `spec.managedBy` field - any value
+other than `kubernetes.io/job-controller` - are skipped by the job controller,
+and their reconciliation is delegated to an external controller, indicated by
+the value of the field. Jobs that don't have this field at all, or where the
+field value is the reserved string `kubernetes.io/job-controller`, are reconciled
+by the built-in job controller. The value of the field is immutable.
+
+{{< note >}}
+The external controller should not create pods with the finalizer name
+`batch.kubernetes.io/job-tracking` reserved for the built-in controller.
+{{< /note >}}
+
 ## Alternatives
 
 ### Bare Pods
diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by-label.md b/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by.md
similarity index 89%
rename from content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by-label.md
rename to content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by.md
index ab4464356fe95..6a69356bf6591 100644
--- a/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by-label.md
+++ b/content/en/docs/reference/command-line-tools-reference/feature-gates/job-managed-by.md
@@ -1,5 +1,5 @@
 ---
-title: JobManagedByLabel
+title: JobManagedBy
 content_type: feature_gate
 
 _build: