Skip to content

Commit 54f74ed

Browse files
committed
docs: address PR comments
1 parent e96f91a commit 54f74ed

File tree

1 file changed

+4
-5
lines changed
  • keps/sig-api-machinery/5073-declarative-validation-with-validation-gen

1 file changed

+4
-5
lines changed

keps/sig-api-machinery/5073-declarative-validation-with-validation-gen/README.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -382,20 +382,20 @@ Each Declarative Validation tag is assigned one of three stability levels: Alpha
382382
#### Alpha
383383

384384
* **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.
387387

388388
#### Beta
389389

390390
* **Description**: Beta tags are more mature, have been tested, and are not expected to change in backward-incompatible ways.
391391
* **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.
393393

394394
#### Stable
395395

396396
* **Description**: Stable tags are production-ready and have undergone rigorous testing.
397397
* **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`).
399399

400400
### DV-Only Implementation Strategy for v1.35
401401
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
15931593
15941594
* **Implementation Complete**: The validation logic is fully implemented and rigorously tested.
15951595
* **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.
15971596
15981597
**Beta to Stable Graduation Criteria:**
15991598

0 commit comments

Comments
 (0)