Skip to content

Update declarative validation docs for current validation-gen workflow#9059

Open
yongruilin wants to merge 1 commit into
kubernetes:mainfrom
yongruilin:docs/declarative-validation-update
Open

Update declarative validation docs for current validation-gen workflow#9059
yongruilin wants to merge 1 commit into
kubernetes:mainfrom
yongruilin:docs/declarative-validation-update

Conversation

@yongruilin

Copy link
Copy Markdown
Contributor

Refresh the API changes and conventions guides to match how declarative
validation works today.

  • Plumbing is already wired for in-tree API groups, so the workflow is now
    just: add tags, regenerate, and test.
  • Document runtime gating via +k8s:ifEnabled/+k8s:ifDisabled and the
    strategy's DeclarativeValidationConfig.
  • Document rollout/migration staging via +k8s:alpha/+k8s:beta.
  • Remove the outdated strategy.go wiring guidance and stale example PR links.

Which issue(s) this PR fixes:

Fixes #

Refresh the API changes and conventions guides to match how declarative
validation works today: plumbing is already wired for in-tree groups, so
the workflow is add tags, regenerate, and test. Document runtime gating
via +k8s:ifEnabled/+k8s:ifDisabled with DeclarativeValidationConfig, and
rollout/migration staging via +k8s:alpha/+k8s:beta. Remove the outdated
strategy.go wiring guidance and stale example PR links.
@kubernetes-prow kubernetes-prow Bot added cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. area/developer-guide Issues or PRs related to the developer guide size/L Denotes a PR that changes 100-499 lines, ignoring generated files. sig/architecture Categorizes an issue or PR as relevant to SIG Architecture. labels Jun 30, 2026
@kubernetes-prow kubernetes-prow Bot requested review from dims and johnbelamaric June 30, 2026 20:51
@kubernetes-prow kubernetes-prow Bot added the sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. label Jun 30, 2026
@yongruilin

Copy link
Copy Markdown
Contributor Author

/assign @jpbetz
/assign @lalitc375

@yongruilin

Copy link
Copy Markdown
Contributor Author

/sig api-machinery

@kubernetes-prow kubernetes-prow Bot added the sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. label Jun 30, 2026
@lalitc375

Copy link
Copy Markdown

/lgtm
/approve

@kubernetes-prow kubernetes-prow Bot added the lgtm "Looks good to me", indicates that a PR is ready to be merged. label Jun 30, 2026
@kubernetes-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: lalitc375, yongruilin
Once this PR has been reviewed and has the lgtm label, please assign derekwaynecarr for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@yongruilin

Copy link
Copy Markdown
Contributor Author

/cc @dims
/cc @johnbelamaric
For approval, thanks!

@dims

dims commented Jul 1, 2026

Copy link
Copy Markdown
Member

/assign @liggitt

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/developer-guide Issues or PRs related to the developer guide cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. lgtm "Looks good to me", indicates that a PR is ready to be merged. sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. sig/architecture Categorizes an issue or PR as relevant to SIG Architecture. sig/contributor-experience Categorizes an issue or PR as relevant to SIG Contributor Experience. size/L Denotes a PR that changes 100-499 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants