docs: add a dedicated page in the website for Kubernetes compatibility.

Summary: For improved discovery, this moves the matrix from the release management file in the Gatekeeper repo, to the Gatekeeper website under the Architecture heading. For better readability and simpler maintenance, instead of using a matrix, we are using a 2 column table. This way, the team won't need to add a new row and column to the matrix for each new release. Reviewers: ritazh Signed-off-by: KayenM <[email protected]>
open-policy-agent · Nov 4, 2024 · 2a7b3a6 · 2a7b3a6
1 parent 75e7da2
commit 2a7b3a6
Show file tree

Hide file tree

Showing 27 changed files with 237 additions and 33 deletions.
diff --git a/docs/Release_Management.md b/docs/Release_Management.md
@@ -60,22 +60,6 @@ Gatekeeper is assumed to be compatible with the [current Kubernetes Supported Ve
 
 For example, if Gatekeeper _supported_ versions are v3.7 and v3.8, and Kubernetes _supported_ versions are v1.22, v1.23, v1.24, then all supported Gatekeeper versions (v3.7, v3.8) are assumed to be compatible with all supported Kubernetes versions (v1.22, v1.23, v1.24). If Kubernetes v1.25 is released later, then Gatekeeper v3.7 and v3.8 will be assumed to be compatible with v1.25 if those Gatekeeper versions are still supported at that time.
 
-This is the official compatibility between Gatekeeper and Kubernetes versions.
-
-|                     | Kubernetes 1.22.z | Kubernetes 1.23.z | Kubernetes 1.24.z | Kubernetes 1.25.z | Kubernetes 1.26.z | Kubernetes 1.27.z | Kubernetes 1.28.z | Kubernetes 1.29.z | Kubernetes 1.30.z | Kubernetes 1.31.z |
-|---------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|-------------------|
-| **Gatekeeper 3.7**  | ✓                 | ✓                 | ✓                 | -                 | -                 | -                 | -                 | -                 | -                 | -                 |
-| **Gatekeeper 3.8**  | ✓                 | ✓                 | ✓                 | ✓                 | -                 | -                 | -                 | -                 | -                 | -                 |
-| **Gatekeeper 3.9**  | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | -                 | -                 | -                 | -                 | -                 |
-| **Gatekeeper 3.10** | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | -                 | -                 | -                 | -                 |
-| **Gatekeeper 3.11** | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 | -                 | -                 | -                 | -                 |
-| **Gatekeeper 3.12** | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | -                 | -                 | -                 |
-| **Gatekeeper 3.13** | -                 | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | -                 | -                 |
-| **Gatekeeper 3.14** | -                 | -                 | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | -                 |
-| **Gatekeeper 3.15** | -                 | -                 | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 |
-| **Gatekeeper 3.16** | -                 | -                 | -                 | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 | ✓                 |
-| **Gatekeeper 3.17** | -                 | -                 | -                 | -                 | -                 | -                 | ✓                 | ✓                 | ✓                 | ✓                 |
-
 If you choose to use Gatekeeper with a version of Kubernetes that it does not support, you are using it at your own risk.
 
 ## Upgrades

diff --git a/website/docs/kubernetes-versions.md b/website/docs/kubernetes-versions.md
@@ -0,0 +1,21 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.17`            | `v1.28`,`v1.29`, `v1.30`, `v1.31`                    |
+| `v3.16`            | `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`           |
+| `v3.15`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`  |
+| `v3.14`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`           |
+| `v3.13`            | `v1.25`, `v1.26`, `v1.27`, `v1.28`, `v1.29`          |
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/sidebars.js b/website/sidebars.js
@@ -46,7 +46,8 @@ module.exports = {
       items: [
         'operations',
         'performance-tuning',
-        'opa-versions'
+        'opa-versions',
+        'kubernetes-versions'
       ],
     },
     {

diff --git a/website/versioned_docs/version-v3.10.x/kubernetes-versions.md b/website/versioned_docs/version-v3.10.x/kubernetes-versions.md
@@ -0,0 +1,14 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.11.x/kubernetes-versions.md b/website/versioned_docs/version-v3.11.x/kubernetes-versions.md
@@ -0,0 +1,15 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.12.x/kubernetes-versions.md b/website/versioned_docs/version-v3.12.x/kubernetes-versions.md
@@ -0,0 +1,16 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.13.x/kubernetes-versions.md b/website/versioned_docs/version-v3.13.x/kubernetes-versions.md
@@ -0,0 +1,17 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.13`            | `v1.25`, `v1.26`, `v1.27`, `v1.28`, `v1.29`          |
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.14.x/kubernetes-versions.md b/website/versioned_docs/version-v3.14.x/kubernetes-versions.md
@@ -0,0 +1,18 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.14`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`           |
+| `v3.13`            | `v1.25`, `v1.26`, `v1.27`, `v1.28`, `v1.29`          |
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.15.x/kubernetes-versions.md b/website/versioned_docs/version-v3.15.x/kubernetes-versions.md
@@ -0,0 +1,19 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.15`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`  |
+| `v3.14`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`           |
+| `v3.13`            | `v1.25`, `v1.26`, `v1.27`, `v1.28`, `v1.29`          |
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.16.x/kubernetes-versions.md b/website/versioned_docs/version-v3.16.x/kubernetes-versions.md
@@ -0,0 +1,20 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.16`            | `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`           |
+| `v3.15`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`  |
+| `v3.14`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`           |
+| `v3.13`            | `v1.25`, `v1.26`, `v1.27`, `v1.28`, `v1.29`          |
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.17.x/kubernetes-versions.md b/website/versioned_docs/version-v3.17.x/kubernetes-versions.md
@@ -0,0 +1,21 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                                  |
+|--------------------|------------------------------------------------------|
+| `v3.17`            | `v1.28`,`v1.29`, `v1.30`, `v1.31`                    |
+| `v3.16`            | `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`           |
+| `v3.15`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`, `v1.31`  |
+| `v3.14`            | `v1.26`, `v1.27`, `v1.28`,`v1.29`, `v1.30`           |
+| `v3.13`            | `v1.25`, `v1.26`, `v1.27`, `v1.28`, `v1.29`          |
+| `v3.12`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`, `v1.28`          |
+| `v3.11`            | `v1.24`, `v1.25`, `v1.26`, `v1.27`                   |
+| `v3.10`            | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`, `v1.27` |
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26`          |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25`          |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24`          |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23`          |
diff --git a/website/versioned_docs/version-v3.6.x/kubernetes-versions.md b/website/versioned_docs/version-v3.6.x/kubernetes-versions.md
@@ -0,0 +1,10 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                         |
+|--------------------|---------------------------------------------|
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23` |
diff --git a/website/versioned_docs/version-v3.7.x/kubernetes-versions.md b/website/versioned_docs/version-v3.7.x/kubernetes-versions.md
@@ -0,0 +1,11 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                         |
+|--------------------|---------------------------------------------|
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24` |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23` |
diff --git a/website/versioned_docs/version-v3.8.x/kubernetes-versions.md b/website/versioned_docs/version-v3.8.x/kubernetes-versions.md
@@ -0,0 +1,12 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                         |
+|--------------------|---------------------------------------------|
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25` |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24` |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23` |
diff --git a/website/versioned_docs/version-v3.9.x/kubernetes-versions.md b/website/versioned_docs/version-v3.9.x/kubernetes-versions.md
@@ -0,0 +1,13 @@
+---
+id: kubernetes-versions
+title: Kubernetes Versions
+---
+
+Gatekeeper is a policy engine for the [Kubernetes Project](https://kubernetes.io/). To see which version of Kubernetes is compatible with a particular Gatekeeper release, reference the table below.
+
+| Gatekeeper Version | Kubernetes Versions                         |
+|--------------------|---------------------------------------------|
+| `v3.9`             | `v1.22`, `v1.23`, `v1.24`, `v1.25`, `v1.26` |
+| `v3.8`             | `v1.21`, `v1.22`, `v1.23`, `v1.24`, `v1.25` |
+| `v3.7`             | `v1.20`, `v1.21`, `v1.22`, `v1.23`, `v1.24` |
+| `v3.6`             | `v1.19`, `v1.20`, `v1.21`, `v1.22`, `v1.23` |
diff --git a/website/versioned_sidebars/version-v3.10.x-sidebars.json b/website/versioned_sidebars/version-v3.10.x-sidebars.json
@@ -43,8 +43,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
-      ]
+        "opa-versions",
+        "kubernetes-versions"      ]
     },
     {
       "type": "category",

diff --git a/website/versioned_sidebars/version-v3.11.x-sidebars.json b/website/versioned_sidebars/version-v3.11.x-sidebars.json
@@ -43,8 +43,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
-      ]
+        "opa-versions",
+        "kubernetes-versions"      ]
     },
     {
       "type": "category",

diff --git a/website/versioned_sidebars/version-v3.12.x-sidebars.json b/website/versioned_sidebars/version-v3.12.x-sidebars.json
@@ -43,8 +43,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
-      ]
+        "opa-versions",
+        "kubernetes-versions"      ]
     },
     {
       "type": "category",

diff --git a/website/versioned_sidebars/version-v3.13.x-sidebars.json b/website/versioned_sidebars/version-v3.13.x-sidebars.json
@@ -45,8 +45,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
-      ]
+        "opa-versions",
+        "kubernetes-versions"      ]
     },
     {
       "type": "category",

diff --git a/website/versioned_sidebars/version-v3.14.x-sidebars.json b/website/versioned_sidebars/version-v3.14.x-sidebars.json
@@ -45,7 +45,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
+        "opa-versions",
+        "kubernetes-versions"
       ]
     },
     {

diff --git a/website/versioned_sidebars/version-v3.15.x-sidebars.json b/website/versioned_sidebars/version-v3.15.x-sidebars.json
@@ -45,7 +45,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
+        "opa-versions",
+        "kubernetes-versions"
       ]
     },
     {

diff --git a/website/versioned_sidebars/version-v3.16.x-sidebars.json b/website/versioned_sidebars/version-v3.16.x-sidebars.json
@@ -45,7 +45,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
+        "opa-versions",
+        "kubernetes-versions"
       ]
     },
     {

diff --git a/website/versioned_sidebars/version-v3.17.x-sidebars.json b/website/versioned_sidebars/version-v3.17.x-sidebars.json
@@ -46,7 +46,8 @@
       "items": [
         "operations",
         "performance-tuning",
-        "opa-versions"
+        "opa-versions",
+        "kubernetes-versions"
       ]
     },
     {

diff --git a/website/versioned_sidebars/version-v3.6.x-sidebars.json b/website/versioned_sidebars/version-v3.6.x-sidebars.json
@@ -100,6 +100,10 @@
         {
           "type": "doc",
           "id": "version-v3.6.x/opa-versions"
+        },
+        {
+          "type": "doc",
+          "id": "version-v3.6.x/kubernetes-versions"
         }
       ]
     },

diff --git a/website/versioned_sidebars/version-v3.7.x-sidebars.json b/website/versioned_sidebars/version-v3.7.x-sidebars.json
@@ -112,6 +112,10 @@
         {
           "type": "doc",
           "id": "version-v3.7.x/opa-versions"
+        },
+        {
+          "type": "doc",
+          "id": "version-v3.7.x/kubernetes-versions"
         }
       ]
     },

diff --git a/website/versioned_sidebars/version-v3.8.x-sidebars.json b/website/versioned_sidebars/version-v3.8.x-sidebars.json
@@ -41,8 +41,8 @@
       "collapsed": false,
       "items": [
         "operations",
-        "opa-versions"
-      ]
+        "opa-versions",
+        "kubernetes-versions"      ]
     },
     {
       "type": "category",

diff --git a/website/versioned_sidebars/version-v3.9.x-sidebars.json b/website/versioned_sidebars/version-v3.9.x-sidebars.json
@@ -41,8 +41,8 @@
       "collapsed": false,
       "items": [
         "operations",
-        "opa-versions"
-      ]
+        "opa-versions",
+        "kubernetes-versions"      ]
     },
     {
       "type": "category",