diff --git a/akka-docs/src/main/paradox/additional/rolling-updates.md b/akka-docs/src/main/paradox/additional/rolling-updates.md
index 74f8e27fb4..7f156e40ab 100644
--- a/akka-docs/src/main/paradox/additional/rolling-updates.md
+++ b/akka-docs/src/main/paradox/additional/rolling-updates.md
@@ -167,9 +167,10 @@ If you need to change any of the following aspects of sharding it will require a
 
  * The `extractShardId` function
  * The role that the shard regions run on
- * The persistence mode - It's important to use the same mode on all nodes in the cluster 
- * If the [amount of nodes](https://doc.akka.io/docs/akka/2.5/cluster-sharding.html#an-example) is changed, the [`number-of-shards`](https://doc.akka.io/docs/akka/current/typed/cluster-sharding.html#shard-allocation) may be adapted as well
-
+ * The persistence mode - It's important to use the same mode on all nodes in the cluster
+ * The @ref:[`number-of-shards`](../typed/cluster-sharding.md#basic-example) - Note: changing the number
+ of nodes in the cluster does not require changing the number of shards.
+ 
 ### Cluster configuration change
 
 * A full restart is required if you change the [SBR strategy](https://doc.akka.io/docs/akka/current/split-brain-resolver.html#strategies)