diff --git a/akka-docs/src/main/paradox/general/actor-systems.md b/akka-docs/src/main/paradox/general/actor-systems.md
index 922a1cbb09..e748fb4350 100644
--- a/akka-docs/src/main/paradox/general/actor-systems.md
+++ b/akka-docs/src/main/paradox/general/actor-systems.md
@@ -107,8 +107,8 @@ while Akka does the heavy lifting under the hood.
 ## Terminating ActorSystem
 
 When you know everything is done for your application, you can have the user guardian
- actor stop, or call the `terminate` method of `ActorSystem`. That will run @ref:[`CoordinatedShutdown`](../coordinated-shutdown.md)
+ actor stop, or call the @scala[@scaladoc[terminate](akka.actor.typed.ActorSystem#terminate():Unit)]@java[@javadoc[terminate()](akka.actor.typed.ActorSystem#terminate())] method of @apidoc[ActorSystem](typed.ActorSystem). That will run @ref:[`CoordinatedShutdown`](../coordinated-shutdown.md)
 stopping all running actors.
 
-If you want to execute some operations while terminating `ActorSystem`,
+If you want to execute some operations while terminating @apidoc[ActorSystem](typed.ActorSystem),
 look at @ref:[`CoordinatedShutdown`](../coordinated-shutdown.md).