diff --git a/docs/pages/installation.mdx b/docs/pages/installation.mdx
index d78662c05483a..63cd0d77ffaed 100644
--- a/docs/pages/installation.mdx
+++ b/docs/pages/installation.mdx
@@ -5,12 +5,23 @@ h1: Installation
 videoBanner: VifXROQFjwg
 ---
 
-<Admonition type="tip" title="First time trying Teleport?">
+This guide shows you how to install Teleport binaries on your platform,
+including:
+- `teleport`
+- `tsh`
+- `tctl`
+- `tbot`
 
 If you are new to Teleport, we recommend following our
 [getting started guides](./try-out-teleport/introduction.mdx).
 
-</Admonition>
+For best results, Teleport clients (`tsh`, `tctl`, `tbot`) should be the same major
+version as the cluster they are connecting to. Teleport servers are compatible
+with clients that are on the same major version or one major version older.
+Teleport servers do not support clients that are on a newer major version.
+
+See our [Upgrading](./management/operations/upgrading.mdx) guide for more information.
+
 
 ## Operating system support
 
@@ -132,7 +143,7 @@ chart.
   <Notice type="danger">
 
   The Teleport package in Homebrew is not maintained by Teleport and we can't
-  guarantee its reliability or security. 
+  guarantee its reliability or security.
 
   </Notice>