@@ -277,12 +277,13 @@ when drafting this test plan.
277
277
278
278
Define graduation milestones.
279
279
280
- These may be defined in terms of API maturity, or as something else. The KEP
281
- should keep this high-level with a focus on what signals will be looked at to
282
- determine graduation.
280
+ These may be defined in terms of API maturity, [feature gate] graduations, or as
281
+ something else. The KEP should keep this high-level with a focus on what
282
+ signals will be looked at to determine graduation.
283
283
284
284
Consider the following in developing the graduation criteria for this enhancement:
285
285
- [Maturity levels (`alpha`, `beta`, `stable`)][maturity-levels]
286
+ - [Feature gate][feature gate] lifecycle
286
287
- [Deprecation policy][deprecation-policy]
287
288
288
289
Clearly define what graduation means by either linking to the [API doc
@@ -292,6 +293,7 @@ or by redefining what graduation means.
292
293
In general we try to use the same stages (alpha, beta, GA), regardless of how the
293
294
functionality is accessed.
294
295
296
+ [feature gate]: https://git.k8s.io/community/contributors/devel/sig-architecture/feature-gates.md
295
297
[maturity-levels]: https://git.k8s.io/community/contributors/devel/sig-architecture/api_changes.md#alpha-beta-and-stable-versions
296
298
[deprecation-policy]: https://kubernetes.io/docs/reference/using-api/deprecation-policy/
297
299
@@ -395,6 +397,12 @@ This section must be completed when targeting alpha to a release.
395
397
396
398
<!--
397
399
Pick one of these and delete the rest.
400
+
401
+ Documentation is available on [feature gate lifecycle] and expectations, as
402
+ well as the [existing list] of feature gates.
403
+
404
+ [feature gate lifecycle]: https://git.k8s.io/community/contributors/devel/sig-architecture/feature-gates.md
405
+ [existing list]: https://kubernetes.io/docs/reference/command-line-tools-reference/feature-gates/
398
406
-->
399
407
400
408
- [ ] Feature gate (also fill in values in ` kep.yaml ` )
@@ -420,6 +428,10 @@ automations, so be extremely careful here.
420
428
Describe the consequences on existing workloads (e.g., if this is a runtime
421
429
feature, can it break the existing applications?).
422
430
431
+ Feature gates are typically disabled by setting the flag to `false` and
432
+ restarting the component. No other changes should be necessary to disable the
433
+ feature.
434
+
423
435
NOTE: Also set `disable-supported` to `true` or `false` in `kep.yaml`.
424
436
-->
425
437
0 commit comments