Skip to content

Commit f73839c

Browse files
committed
add beta-off-by-default criteria for adding to PRR questionaire
1 parent ead3b89 commit f73839c

File tree

1 file changed

+7
-1
lines changed
  • keps/sig-architecture/3136-beta-apis-off-by-default

1 file changed

+7
-1
lines changed

keps/sig-architecture/3136-beta-apis-off-by-default/README.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -173,7 +173,10 @@ This is now practical to do since conformance no longer relies on non-stable API
173173

174174
### Non-Goals
175175

176-
1. Change featuregate defaults.
176+
1. Change feature gate defaults.
177+
Feature gates control new features (not just new APIs) and they are on by default for beta features.
178+
This KEP is not changing the lifecycle flow for feature gates.
179+
It is currently alpha=off-by-default, beta=on-by-default, stable=locked-to-on.
177180

178181
## Proposal
179182

@@ -219,6 +222,8 @@ While this is a risk, it is not very common and components should fail safe as a
219222
If beta APIs are off by default, it's possible that fewer clients will use them and provide feedback.
220223
This is a risk, but early adopters are able to enable these features and have a history of enabling alpha features.
221224
When moving from beta to GA, it will be important for sigs to explicitly seek feedback.
225+
We will address this by extending the PRR questionnaire to include a GA-targeted question to validate that the feature
226+
was reasonably validated in production use-cases.
222227

223228
If beta APIs are off by default, it is possible that sigs don't treat taking an API as an indication of a "mostly-baked" API.
224229
If this happens, then more transformation may be required.
@@ -253,6 +258,7 @@ This KEP is a policy KEP, not a feature KEP. It will start as GA.
253258
- email to [email protected] to explain the new policy
254259
- blog post explaining change in time for 1.24 release
255260
- CI configuration updated to have a testing mode that enables beta APIs, likely set using `kube-apiserver --runtime-config=api/beta=true`
261+
- extend the PRR questionnaire to include a GA-targeted question to validate that the feature was reasonably validated in production use-cases.
256262

257263
### Upgrade / Downgrade Strategy
258264

0 commit comments

Comments
 (0)