From 62ce43c4e62640c279bcf51855d6701bd1b48db7 Mon Sep 17 00:00:00 2001
From: Rafal Skolasinski <r.j.skolasinski@gmail.com>
Date: Wed, 24 May 2023 10:19:57 +0100
Subject: [PATCH] V1: Add K8s compatibility matrix to installation page (#4862)

* update gitignore

* add compatibility matrix to installation page
---
 .gitignore                      |  2 ++
 doc/source/workflow/install.rst | 29 ++++++++++++++++++++++++++++-
 2 files changed, 30 insertions(+), 1 deletion(-)

diff --git a/.gitignore b/.gitignore
index ca17853ba1..8ef0b4d6eb 100644
--- a/.gitignore
+++ b/.gitignore
@@ -231,3 +231,5 @@ examples/models/autoscaling/autoscaling_example.py
 
 # python venv
 venv/
+go.work
+go.work.sum
diff --git a/doc/source/workflow/install.rst b/doc/source/workflow/install.rst
index 6df1a53109..3b8a80cc79 100644
--- a/doc/source/workflow/install.rst
+++ b/doc/source/workflow/install.rst
@@ -18,6 +18,33 @@ Pre-requisites:
    -  Istio : we recommend >= 1.16
    -  Ambassador v1 and v2
 
+
+Kubernetes Compatibility Matrix
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Seldon Core 1.16 bumps minimum Kubernetes version to 1.23.
+This is because as part of making Seldon Core compatible with Kubernetes 1.25 we moved from autoscaling/v2beta1 apiVersion of HorizontalPodAutoscaler to autoscaling/v2 (see this [PR](https://github.com/SeldonIO/seldon-core/pull/4172) for further details).
+
+Following table provides a summary of Seldon Core / Kubernetes version compatibility for recent version of Seldon Core.
+
++----------------------------+------+------+------+------+------+------+
+| Core Version \ K8s Version | 1.21 | 1.22 | 1.23 | 1.24 | 1.25 | 1.26 |
++============================+======+======+======+======+======+======+
+| 1.11                       | ✓    |      |      |      |      |      |
++----------------------------+------+------+------+------+------+------+
+| 1.12                       | ✓    | ✓    | ✓    | ✓    |      |      |
++----------------------------+------+------+------+------+------+------+
+| 1.13                       | ✓    | ✓    | ✓    | ✓    |      |      |
++----------------------------+------+------+------+------+------+------+
+| 1.14                       | ✓    | ✓    | ✓    | ✓    |      |      |
++----------------------------+------+------+------+------+------+------+
+| 1.15                       | ✓    | ✓    | ✓    | ✓    |      |      |
++----------------------------+------+------+------+------+------+------+
+| 1.16                       |      |      | ✓    | ✓    | ✓    | ✓    |
++----------------------------+------+------+------+------+------+------+
+
+It is always recommended to first upgrade Seldon Core to the latest supported version on your Kubernetes cluster and then upgrade the Kubernetes cluster.
+
 Running older versions of Seldon Core?
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -77,7 +104,7 @@ Now we can install Seldon Core in the ``seldon-system`` namespace.
 For full instructions on installation with Istio and Ambassador read the
 following pages:
 
-* `Ingress with Istio <../ingress/istio.md>`__ 
+* `Ingress with Istio <../ingress/istio.md>`__
 * `Ingress with Ambassador <../ingress/ambassador.md>`__
 
 Install a specific version