Skip to content

Conversation

aaron-prindle
Copy link

Which issue(s) this PR fixes:

Fixes #8559

Issue text copied below for context:

As of v1.33, Kubernetes supports declarative validation for API developers.

The kubernetes/community documentation at:

  • contributors/devel/sig-architecture/api_changes.md
  • contributors/devel/sig-architecture/api-conventions.md

should be updated to reference declarative validation where appropriate, explain that it is the preferred way to declare validation of types and fields for supported validations, and explain how to use it generally.

@k8s-ci-robot
Copy link
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: aaron-prindle
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.

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

@k8s-ci-robot k8s-ci-robot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Aug 25, 2025
@k8s-ci-robot k8s-ci-robot added area/developer-guide Issues or PRs related to the developer guide 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/M Denotes a PR that changes 30-99 lines, ignoring generated files. labels Aug 25, 2025
@aaron-prindle aaron-prindle changed the title docs: add declarative validation documentation docs: update api_changes.md and api_conventions.md with declarative validation information Aug 25, 2025
@aaron-prindle
Copy link
Author

/cc @lmktfy

@k8s-ci-robot k8s-ci-robot requested a review from lmktfy August 25, 2025 01:36
@aaron-prindle
Copy link
Author

/sig architecture api-machinery

@k8s-ci-robot k8s-ci-robot added the sig/api-machinery Categorizes an issue or PR as relevant to SIG API Machinery. label Aug 25, 2025
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. 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/M Denotes a PR that changes 30-99 lines, ignoring generated files.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Update API change and API convention documentation to reference declarative validation
2 participants