Merge pull request #51978 from aaron-prindle/declarative-validation-tag-reference

k8s-ci-robot · web-flow · commit 145a3c022e03 · 2025-08-26T01:52:13.000-07:00
docs: add declarative validation tag reference documentation and link doc in appropriate places
diff --git a/content/en/docs/reference/using-api/_index.md b/content/en/docs/reference/using-api/_index.md
@@ -130,3 +130,4 @@ Kubernetes stores its serialized state in terms of the API resources by writing
 - Learn more about [API conventions](https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#api-conventions)
 - Read the design documentation for
   [aggregator](https://git.k8s.io/design-proposals-archive/api-machinery/aggregated-api-servers.md)
+- Learn about [Declarative API Validation](/docs/reference/using-api/declarative-validation/).
diff --git a/content/en/docs/reference/using-api/api-concepts.md b/content/en/docs/reference/using-api/api-concepts.md
@@ -1011,6 +1011,11 @@ a boolean flag.
 
 {{< /note >}}
 
+Starting from v1.33, Kubernetes (including v{{< skew currentVersion>}}) offers a way to define field validations using _declarative tags_.
+This is useful for people contributing to Kubernetes itself, and it's also relevant if you're
+writing your own API using Kubernetes libraries.
+To learn more, see [Declarative API Validation](/docs/reference/using-api/declarative-validation/).
+
 ## Dry-run
 
 {{< feature-state feature_gate_name="DryRun" >}}
diff --git a/content/en/docs/reference/using-api/declarative-validation.md b/content/en/docs/reference/using-api/declarative-validation.md
