Update content/en/docs/concepts/overview/kubernetes-api.md

Co-authored-by: Tim Bannister <[email protected]>
kubernetes · Nov 29, 2021 · cdc0c24 · cdc0c24
1 parent 2216bd2
commit cdc0c24
Showing 1 changed file with 5 additions and 1 deletion.
diff --git a/content/en/docs/concepts/overview/kubernetes-api.md b/content/en/docs/concepts/overview/kubernetes-api.md
@@ -83,7 +83,11 @@ packages that define the API objects.
 
 {{< feature-state state="alpha"  for_k8s_version="v1.23" >}}
 
-OpenAPI V3 publication can be enabled with the feature gate `OpenAPIV3` and is disabled by default. See [Feature Gates](/docs/reference/command-line-tools-reference/feature-gates/) for a genral explanation of feature gates and how to enable them.
+Kubernetes v1.23 offers initial support for publishing its APIs as OpenAPI v3; this is an
+alpha feature that is disabled by default.
+You can enable the alpha feature by turning on the
+[feature gate](/docs/reference/command-line-tools-reference/feature-gates/) named `OpenAPIV3`
+for the kube-apiserver component.
 
 With the feature enabled, the Kubernetes API server serves an aggregated OpenAPI v3 spec per Kubernetes group version at the `/openapi/v3/apis/<group>/<version>` endpoint.
 The same request headers are supported in v3 and v2, with one exception that `application/[email protected]+protobuf` is used for the Accept header for protobuf OpenAPI v3.