Merge pull request #46912 from serathius/kep2340beta2

Beta documentation for Consistent Reads from Cache

Author: k8s-ci-robot

content/en/docs/reference/command-line-tools-reference/feature-gates/consistent-list-from-cache.md

@@ -9,6 +9,18 @@ stages:
   - stage: alpha
     defaultValue: false
     fromVersion: "1.28"
+    toVersion: "1.30"
+  - stage: beta
+    defaultValue: true
+    fromVersion: "1.31"
 ---
-Allow the API server to serve consistent lists from cache.
+Enhance Kubernetes API server performance by serving consistent **list** requests
+directly from its watch cache, improving scalability and response times.
+To consistent list from cache Kubernetes requires a newer etcd version (v3.4.31+ or v3.5.13+),
+that includes fixes to watch progress request feature.
+If older etcd version is provided Kubernetes will automatically detect it and fallback to serving consistent reads from etcd.
+Progress notifications ensure watch cache is consistent with etcd while reducing
+the need for resource-intensive quorum reads from etcd.
+
+See the Kubernetes documentation on [Semantics for **get** and **list**](/docs/reference/using-api/api-concepts/#semantics-for-get-and-list) for more details.
 

content/en/docs/reference/using-api/api-concepts.md

@@ -1168,6 +1168,11 @@ Any
 Most recent
 : Return data at the most recent resource version. The returned data must be
   consistent (in detail: served from etcd via a quorum read).
+  For etcd v3.4.31+ and v3.5.13+ Kubernetes {{< skew currentVersion >}} serves “most recent” reads from the _watch cache_:
+  an internal, in-memory store within the API server that caches and mirrors the state of data
+  persisted into etcd. Kubernetes requests progress notification to maintain cache consistency against
+  the etcd persistence layer. Kubernetes versions v1.28 through to v1.30 also supported this
+  feature, although as Alpha it was not recommended for production nor enabled by default until the v1.31 release.
 
 Not older than
 : Return data at least as new as the provided `resourceVersion`. The newest