diff --git a/akka-docs/src/main/paradox/fsm.md b/akka-docs/src/main/paradox/fsm.md
index b9c6d88e9a..7902a16b4d 100644
--- a/akka-docs/src/main/paradox/fsm.md
+++ b/akka-docs/src/main/paradox/fsm.md
@@ -1,7 +1,7 @@
 # Classic FSM
 
 @@include[includes.md](includes.md) { #actor-api }
-For the full documentation of this feature and for new projects see @ref:[fsm](typed/fsm.md).
+For the documentation of the new API of this feature and for new projects see @ref:[fsm](typed/fsm.md).
 
 ## Dependency
 
diff --git a/akka-docs/src/main/paradox/routing.md b/akka-docs/src/main/paradox/routing.md
index c184bc8e1a..ddd3d01f76 100644
--- a/akka-docs/src/main/paradox/routing.md
+++ b/akka-docs/src/main/paradox/routing.md
@@ -1,7 +1,7 @@
 # Classic Routing
 
 @@include[includes.md](includes.md) { #actor-api }
-For the full documentation of this feature and for new projects see @ref:[routers](typed/routers.md).
+For the documentation of the new API of this feature and for new projects see @ref:[routers](typed/routers.md).
 
 ## Dependency