diff --git a/akka-docs/src/main/paradox/additional/deploying.md b/akka-docs/src/main/paradox/additional/deploying.md
index 10514b8ea6..de376e05e2 100644
--- a/akka-docs/src/main/paradox/additional/deploying.md
+++ b/akka-docs/src/main/paradox/additional/deploying.md
@@ -3,6 +3,24 @@ project.description: How to deploy Akka Cluster to Kubernetes and Docker.
 ---
 # Deploying
 
+## Deploying to Kubernetes
+
+See the guide and example project for [Deploying Akka Cluster to Kubernetes](https://doc.akka.io/docs/akka-management/current/kubernetes-deployment/index.html).
+
+### Cluster bootstrap
+
+To take advantage of running inside Kubernetes while forming a cluster, 
+[Akka Cluster Bootstrap](https://doc.akka.io/docs/akka-management/current/bootstrap/) helps forming or joining a cluster using Akka Discovery to discover peer nodes. 
+with the Kubernetes API or Kubernetes via DNS.  
+
+You can look at the
+@extref[Cluster with Kubernetes example project](samples:akka-sample-cluster-kubernetes-java)
+to see what this looks like in practice.
+ 
+### Resource limits
+
+To avoid CFS scheduler limits, it is best not to use `resources.limits.cpu` limits, but use `resources.requests.cpu` configuration instead.
+
 ## Deploying to Docker containers
 
 You can use both Akka remoting and Akka Cluster inside Docker containers. Note
@@ -32,18 +50,3 @@ starved of CPU time, but your system appears idle.
 
 For this reason, it is best to avoid `--cpus` and `--cpu-quota` entirely, and instead specify relative container weights using `--cpu-shares` instead.
 
-## Deploying to Kubernetes
-
-### Cluster bootstrap
-
-To take advantage of running inside Kubernetes while forming a cluster, 
-[Akka Cluster Bootstrap](https://doc.akka.io/docs/akka-management/current/bootstrap/) helps forming or joining a cluster using Akka Discovery to discover peer nodes. 
-with the Kubernetes API or Kubernetes via DNS.  
-
-You can look at the
-@extref[Cluster with Kubernetes example project](samples:akka-sample-cluster-kubernetes-java)
-to see what this looks like in practice.
- 
-### Resource limits
-
-To avoid CFS scheduler limits, it is best not to use `resources.limits.cpu` limits, but use `resources.requests.cpu` configuration instead.