From ce1c03d30caffd32abc0232cad9aebf4123dd68e Mon Sep 17 00:00:00 2001
From: David Yu <dyu@hashicorp.com>
Date: Mon, 14 Sep 2020 10:24:39 -0700
Subject: [PATCH] Create compatability.mdx for Consul Kubernetes docs (#8655)

Create Compatibility Matrix page for Consul and Consul on Kubernetes underneath Upgrade section in the Kubernetes docs.
---
 website/data/docs-navigation.js               |  5 ++++-
 .../pages/docs/k8s/upgrade/compatibility.mdx  | 20 +++++++++++++++++++
 .../k8s/{upgrade.mdx => upgrade/index.mdx}    |  0
 3 files changed, 24 insertions(+), 1 deletion(-)
 create mode 100644 website/pages/docs/k8s/upgrade/compatibility.mdx
 rename website/pages/docs/k8s/{upgrade.mdx => upgrade/index.mdx} (100%)

diff --git a/website/data/docs-navigation.js b/website/data/docs-navigation.js
index f4b8730511..016df94c68 100644
--- a/website/data/docs-navigation.js
+++ b/website/data/docs-navigation.js
@@ -155,7 +155,10 @@ export default [
       },
       'service-sync',
       'dns',
-      'upgrade',
+      {
+        category: 'upgrade',
+        content: ['compatibility'],
+      },
       'uninstall',
       'helm',
     ],
diff --git a/website/pages/docs/k8s/upgrade/compatibility.mdx b/website/pages/docs/k8s/upgrade/compatibility.mdx
new file mode 100644
index 0000000000..62c50f1871
--- /dev/null
+++ b/website/pages/docs/k8s/upgrade/compatibility.mdx
@@ -0,0 +1,20 @@
+---
+layout: docs
+page_title: Compatibility Matrix
+sidebar_title: Compatibility Matrix
+description: Compatibility Matrix for Consul Kubernetes and Consul
+---
+
+# Compatibility Matrix for Consul Kubernetes and Consul 
+
+Consul Kubernetes (consul-k8s) is managed using Consul Helm. For every release of Consul Kubernetes, a new version of the Consul Kubernetes 
+Helm chart and Consul Kubernetes binary is released through the HashiCorp Helm repository. The recommended best practice is to upgrade
+the Helm chart which will ensure a compatible version of the Consul Kubernetes binary is used.
+
+## Supported Versions
+
+| Consul Version      | Compatible Consul Helm Versions  |
+| ------------------- | -------------------------------- |
+| 1.8.x               | 0.22.0 - 0.24.1                  |
+| 1.7.x               | 0.17.0 - 0.21.0                  |
+| 1.6.x               | 0.10.0 - 0.16.2                  |
diff --git a/website/pages/docs/k8s/upgrade.mdx b/website/pages/docs/k8s/upgrade/index.mdx
similarity index 100%
rename from website/pages/docs/k8s/upgrade.mdx
rename to website/pages/docs/k8s/upgrade/index.mdx