elaborate on support policy

jawnsy · jawnsy · commit 185b308a32f0 · 2021-07-10T22:10:45.000Z
diff --git a/setup/kubernetes/index.md b/setup/kubernetes/index.md
@@ -4,21 +4,28 @@ description: Learn how to set up a Kubernetes cluster for your Coder deployment.
 ---
 
 You can deploy Coder into any [compatible Kubernetes cluster]. Coder follows the
-[Kubernetes upstream version support policy] and the latest stable release
+[Kubernetes upstream version support policy], and the latest stable release
 version of Coder supports the previous two minor releases as well as the current
-release. While Coder may run on older versions of Kubernetes, we strongly
-recommend running one of the supported versions, in order to receive applicable
-fixes, including security fixes, from the project maintainers.
+release of Kubernetes at time of publication. Coder may run successfully with
+older versions of Kubernetes, however, we strongly recommend running one of the
+currently-supported versions, in order to receive applicable fixes, including
+security fixes, from the Kubernetes project maintainers.
 
-[compatible kubernetes cluster]: ../requirements.md
-[kubernetes upstream version support policy]:
-  https://kubernetes.io/docs/setup/release/version-skew-policy/
+Coder continuously removes usage of deprecated Kubernetes API versions once
+the minimum baseline version of Kubernetes supports the necessary features in
+a stable version. We follow this policy in order to ensure that Coder stops
+using deprecated features before they are removed from new versions of
+Kubernetes.
 
 This section contains guides for creating a compatible cluster on common cloud
 platforms, including Microsoft Azure, Google Cloud Platform, and Amazon Web
 Services. If you already have a Kubernetes cluster, you may wish to proceed to
 the [installation guide].
 
+[compatible kubernetes cluster]: ../requirements.md
+[kubernetes upstream version support policy]:
+  https://kubernetes.io/docs/setup/release/version-skew-policy/
+
 [installation guide]: ../installation.md
 
 <children></children>
