From 176152278bc5edd91f5bf27dc57900933bcd500e Mon Sep 17 00:00:00 2001
From: Patrik Nordwall <patrik.nordwall@gmail.com>
Date: Tue, 26 May 2020 13:09:01 +0200
Subject: [PATCH] doc: add routers to Higher level Cluster tools (#29117)

---
 akka-docs/src/main/paradox/includes/cluster.md | 8 ++++++++
 akka-docs/src/main/paradox/typed/cluster.md    | 6 +++++-
 2 files changed, 13 insertions(+), 1 deletion(-)

diff --git a/akka-docs/src/main/paradox/includes/cluster.md b/akka-docs/src/main/paradox/includes/cluster.md
index 242b956d87..58e61c8418 100644
--- a/akka-docs/src/main/paradox/includes/cluster.md
+++ b/akka-docs/src/main/paradox/includes/cluster.md
@@ -33,6 +33,14 @@ i.e. the sender does not have to know on which node the destination actor is run
 
 <!--- #cluster-pubsub --->
 
+<!--- #cluster-router --->
+### Cluster aware routers
+
+Distribute messages to actors on different nodes in the cluster with routing strategies
+like round-robin and consistent hashing.
+
+<!--- #cluster-router --->
+
 <!--- #cluster-multidc --->
 ### Cluster across multiple data centers
 
diff --git a/akka-docs/src/main/paradox/typed/cluster.md b/akka-docs/src/main/paradox/typed/cluster.md
index 8ab5d24e86..fa007ae31e 100644
--- a/akka-docs/src/main/paradox/typed/cluster.md
+++ b/akka-docs/src/main/paradox/typed/cluster.md
@@ -438,7 +438,11 @@ See @ref:[Cluster Sharding](cluster-sharding.md).
 @@include[cluster.md](../includes/cluster.md) { #cluster-ddata } 
 See @ref:[Distributed Data](distributed-data.md).
 
-@@include[cluster.md](../includes/cluster.md) { #cluster-pubsub } 
+@@include[cluster.md](../includes/cluster.md) { #cluster-pubsub }
+See @ref:[Distributed Publish Subscribe](distributed-pub-sub.md).
+
+@@include[cluster.md](../includes/cluster.md) { #cluster-router }
+See @ref:[Group Routers](routers.md#group-router). 
 
 @@include[cluster.md](../includes/cluster.md) { #cluster-multidc }
 See @ref:[Cluster Multi-DC](cluster-dc.md).