You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: keps/sig-api-machinery/5073-declarative-validation-with-validation-gen/README.md
+4-5Lines changed: 4 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -382,20 +382,20 @@ Each Declarative Validation tag is assigned one of three stability levels: Alpha
382
382
#### Alpha
383
383
384
384
***Description**: Alpha tags are experimental, intended for early development and testing, and are subject to backward-incompatible changes.
385
-
***Guarantees**: The API machinery team may introduce backward-incompatible changes.
386
-
***Usage**: When used in the Kubernetes repository, Alpha tags must be mirrored with a handwritten implementation for at least one release before promotion to Beta.
385
+
***Guarantees**: Backward-incompatible changes are allowed. All in-tree tag usage will be updated to adapt to the change, but out-of-tree tag usage may break.
386
+
***Usage**: When used in the Kubernetes repository, Alpha tags must be mirrored with a handwritten implementation.
387
387
388
388
#### Beta
389
389
390
390
***Description**: Beta tags are more mature, have been tested, and are not expected to change in backward-incompatible ways.
391
391
***Guarantees**: All modifications to Beta tags must be backward-compatible.
392
-
***Usage**: Beta tags are suitable for use in Kubernetes features that are in the Alpha or Beta stage of their lifecycle.
392
+
***Usage**: Beta tags may be used in Kubernetes features/APIs that are in the Alpha or Beta stage of their lifecycle. Beta tags may be defined as 'DV-Only' validations i.e., on fields marked with `+k8s:declarativeValidationNative`) when used with Alpha or Beta features/APIs. Stable Kubernetes features/APIs may only use Beta tags when mirrored with hand written validation.
393
393
394
394
#### Stable
395
395
396
396
***Description**: Stable tags are production-ready and have undergone rigorous testing.
397
397
***Guarantees**: All modifications must be backward-compatible.
398
-
***Usage**: Only Stable tags are permitted for use in 'DV-Only' validations (i.e., on fields marked with `+k8s:declarativeValidationNative`), unless the API type is alpha or beta.
398
+
***Usage**: Stable tags may be used with all features/APIs. Stable tags may be defined as 'DV-Only' validations (i.e., on fields marked with `+k8s:declarativeValidationNative`).
399
399
400
400
### DV-Only Implementation Strategy for v1.35
401
401
No DV-Only usage will be permitted in v1.35. Instead, the v1.35 release will focus on:
@@ -1593,7 +1593,6 @@ This track is for tags that are always used in combination with other tags or th
1593
1593
1594
1594
* **Implementation Complete**: The validation logic is fully implemented and rigorously tested.
1595
1595
* **Leadership Confidence**: Declarative validation subproject leads are confident in the implementation.
1596
-
* **Monitored in Production**: The tag has been used with mirrored handwritten code for at least one release cycle with zero mismatches.
0 commit comments