KEP-5647: Stale informer docs

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

@@ -0,0 +1,19 @@
+---
+title: AtomicFIFO
+content_type: feature_gate
+
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.36"
+
+---
+A client-go implementation of a FIFO queue that uses atomic operations to ensure events that come in
+batches, such as those from a ListAndWatch call, are processed in a single chunk. This is in contrast to
+the previous implementation which would process these events one by one, potentially causing the internal
+cache to become temporarily inconsistent with the API server. This feature gate can be toggled in the
+kube-controller-manager and any client-go based controller.

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

@@ -0,0 +1,15 @@
+---
+title: StaleControllerConsistencyDaemonSet
+content_type: feature_gate
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.36"
+---
+Enables behavior within the DaemonSet controller to ensure that prior writes to
+the API server are observed before proceeding with additional reconciliation for the same DaemonSet.
+This is to prevent stale cache from causing incorrect or spurious updates to the DaemonSet.

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

@@ -0,0 +1,15 @@
+---
+title: StaleControllerConsistencyJob
+content_type: feature_gate
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.36"
+---
+Enables behavior within the Job controller to ensure that prior writes to
+the API server are observed before proceeding with additional reconciliation for the same Job.
+This is to prevent stale cache from causing incorrect or spurious updates to the Job.

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

@@ -0,0 +1,15 @@
+---
+title: StaleControllerConsistencyReplicaSet
+content_type: feature_gate
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: beta
+    defaultValue: true  
+    fromVersion: "1.36"
+---
+Enables behavior within the ReplicaSet controller to ensure that prior writes to
+the API server are observed before proceeding with additional reconciliation for the same ReplicaSet.
+This is to prevent stale cache from causing incorrect or spurious updates to the ReplicaSet.

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

@@ -0,0 +1,15 @@
+---
+title: StaleControllerConsistencyStatefulSet
+content_type: feature_gate
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.36"
+---
+Enables behavior within the StatefulSet controller to ensure that prior writes to
+the API server are observed before proceeding with additional reconciliation for the same StatefulSet.
+This is to prevent stale cache from causing incorrect or spurious updates to the StatefulSet.

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

@@ -0,0 +1,21 @@
+---
+title: UnlockWhileProcessingFIFO
+content_type: feature_gate
+
+_build:
+  list: never
+  render: false
+
+stages:
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.36"
+---
+
+Enable use of a FIFO queue within client-go that unlocks while processing events. If not enabled, 
+the queue instead holds the lock for the entire duration of processing events, which could lead 
+to performance issues in high-throughput scenarios. This feature gate can be toggled in the
+kube-controller-manager and any client-go based controller.
+
+You can only enable this feature gate if the
+[AtomicFIFO](/docs/reference/command-line-tools-reference/feature-gates/#AtomicFIFO) feature gate is also enabled.