Update "KEP-168-pending-workload-visibility" before deprecation.

keps/168-pending-workloads-visibility/README.md

@@ -43,8 +43,8 @@ tags, and then generate with `hack/update-toc.sh`.
     - [Unit Tests](#unit-tests)
     - [Integration tests](#integration-tests)
   - [Graduation Criteria](#graduation-criteria)
-    - [Beta](#beta)
-    - [Stable](#stable)
+    - [Alpha](#alpha)
+    - [Deprecation](#deprecation)
 - [Implementation History](#implementation-history)
 - [Drawbacks](#drawbacks)
 - [Alternatives](#alternatives)
@@ -515,7 +515,7 @@ After the implementation PR is merged, add the names of the tests here.
 
 ### Graduation Criteria
 
-#### Beta
+#### Alpha
 
 First iteration (0.5):
 
@@ -530,9 +530,19 @@ Third iteration (0.7):
 
 - reevaluate the need for exposing positions and support if needed
 
-#### Stable
+#### Deprecation
 
-- drop the feature gate
+We deprecate the feature, and going to remove it in feature versions of the API,
+in favor of monitoring pending workloads using the [on-demand visibility API](https://kueue.sigs.k8s.io/docs/tasks/manage/monitor_pending_workloads/pending_workloads_on_demand/).
+
+First iteration (0.9):
+
+- deprecate the QueueVisibility feature gate and corresponding API.
+
+Second iteration (v1beta2):
+
+- remove the QueueVisibility feature gate,
+- remove PendingWorkloadsStatus field from ClusterQueue object and QueueVisibility field from Config object on bumping the API version.
 
 <!--
 

keps/168-pending-workloads-visibility/kep.yaml

@@ -12,13 +12,16 @@ approvers:
   - "@ahg-g"
   - "@alculquicondor"
 
-stage: beta
+see-also:
+  - "/keps/168-2-pending-workloads-visibility"
 
-latest-milestone: "v0.5"
+stage: deprecated
+
+latest-milestone: "v0.9"
 
 milestone:
-  beta: "v0.5"
-  stable: "v0.8"
+  alpha: "v0.5"
+  deprecated: "v0.9"
 
 disable-supported: true