diff --git a/akka-docs/src/main/paradox/remoting-artery.md b/akka-docs/src/main/paradox/remoting-artery.md
index 431085cd9d..7497fd9ae8 100644
--- a/akka-docs/src/main/paradox/remoting-artery.md
+++ b/akka-docs/src/main/paradox/remoting-artery.md
@@ -48,6 +48,7 @@ to your `application.conf` file:
 ```
 akka {
   actor {
+    # provider=remote is possible, but prefer cluster
     provider = cluster 
   }
   remote {
@@ -62,7 +63,7 @@ akka {
 
 As you can see in the example above there are four things you need to add to get started:
 
- * Change provider from `local` to `cluster`
+Change provider from `local`. We recommend using @ref:[Akka Cluster](cluster-usage.md) over using remoting directly.
  * Enable Artery to use it as the remoting implementation
  * Add host name - the machine you want to run the actor system on; this host
 name is exactly what is passed to remote systems in order to identify this
diff --git a/akka-docs/src/main/paradox/remoting.md b/akka-docs/src/main/paradox/remoting.md
index 7ff67cf23f..430d0e2b6d 100644
--- a/akka-docs/src/main/paradox/remoting.md
+++ b/akka-docs/src/main/paradox/remoting.md
@@ -49,7 +49,8 @@ to your `application.conf` file:
 ```
 akka {
   actor {
-    provider = remote
+    # provider=remote is possible, but prefer cluster
+    provider = cluster
   }
   remote.artery.enabled = false
   remote.classic {
@@ -64,7 +65,7 @@ akka {
 
 As you can see in the example above there are five things you need to add to get started:
 
- * Change provider from `local` to `remote`
+ * Change provider from `local`. We recommend using @ref:[Akka Cluster](cluster-usage.md) over using remoting directly.
  * Disable artery remoting. Artery is the default remoting implementation since `2.6.0`
  * Add host name - the machine you want to run the actor system on; this host
 name is exactly what is passed to remote systems in order to identify this