diff --git a/akka-docs/src/main/paradox/java/index-actors.md b/akka-docs/src/main/paradox/java/index-actors.md
deleted file mode 100644
index 6b7db6aa6b..0000000000
--- a/akka-docs/src/main/paradox/java/index-actors.md
+++ /dev/null
@@ -1,21 +0,0 @@
-# Actors
-
-@@toc { depth=2 }
-
-@@@ index
-
-* [actors](actors.md)
-* [typed](typed.md)
-* [fault-tolerance](fault-tolerance.md)
-* [dispatchers](dispatchers.md)
-* [mailboxes](mailboxes.md)
-* [routing](routing.md)
-* [fsm](fsm.md)
-* [persistence](persistence.md)
-* [persistence-schema-evolution](persistence-schema-evolution.md)
-* [persistence-query](persistence-query.md)
-* [persistence-query-leveldb](persistence-query-leveldb.md)
-* [testing](testing.md)
-* [typed-actors](typed-actors.md)
-
-@@@
diff --git a/akka-docs/src/main/paradox/java/index-actors.md b/akka-docs/src/main/paradox/java/index-actors.md
new file mode 120000
index 0000000000..30b1c95631
--- /dev/null
+++ b/akka-docs/src/main/paradox/java/index-actors.md
@@ -0,0 +1 @@
+../scala/index-actors.md
\ No newline at end of file
diff --git a/akka-docs/src/main/paradox/scala/actordsl.md b/akka-docs/src/main/paradox/scala/actordsl.md
deleted file mode 100644
index 9892c895d8..0000000000
--- a/akka-docs/src/main/paradox/scala/actordsl.md
+++ /dev/null
@@ -1,82 +0,0 @@
-# Actor DSL
-
-@@@ warning
-
-Actor DSL is deprecated and will be removed in the near future.
-Use plain `system.actorOf` or `context.actorOf` instead.
-
-@@@
-
-## The Actor DSL
-
-Simple actors—for example one-off workers or even when trying things out in the
-REPL—can be created more concisely using the `Act` trait. The supporting
-infrastructure is bundled in the following import:
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #import }
-
-This import is assumed for all code samples throughout this section. The
-implicit actor system serves as `ActorRefFactory` for all examples
-below. To define a simple actor, the following is sufficient:
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #simple-actor }
-
-Here, `actor` takes the role of either `system.actorOf` or
-`context.actorOf`, depending on which context it is called in: it takes an
-implicit `ActorRefFactory`, which within an actor is available in the
-form of the `implicit val context: ActorContext`. Outside of an actor, you’ll
-have to either declare an implicit `ActorSystem`, or you can give the
-factory explicitly (see further below).
-
-The two possible ways of issuing a `context.become` (replacing or adding the
-new behavior) are offered separately to enable a clutter-free notation of
-nested receives:
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #becomeStacked }
-
-Please note that calling `unbecome` more often than `becomeStacked` results
-in the original behavior being installed, which in case of the `Act`
-trait is the empty behavior (the outer `become` just replaces it during
-construction).
-
-### Life-cycle management
-
-Life-cycle hooks are also exposed as DSL elements (see @ref:[Start Hook](actors.md#start-hook) and @ref:[Stop Hook](actors.md#stop-hook)), where later invocations of the methods shown below will replace the contents of the respective hooks:
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #simple-start-stop }
-
-The above is enough if the logical life-cycle of the actor matches the restart
-cycles (i.e. `whenStopping` is executed before a restart and `whenStarting`
-afterwards). If that is not desired, use the following two hooks (see @ref:[Restart Hooks](actors.md#restart-hook)):
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #failing-actor }
-
-It is also possible to create nested actors, i.e. grand-children, like this:
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #nested-actor }
-
-@@@ note
-
-In some cases it will be necessary to explicitly pass the
-`ActorRefFactory` to the `actor()` method (you will notice when
-the compiler tells you about ambiguous implicits).
-
-@@@
-
-The grand-child will be supervised by the child; the supervisor strategy for
-this relationship can also be configured using a DSL element (supervision
-directives are part of the `Act` trait):
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #supervise-with }
-
-### Actor with `Stash`
-
-Last but not least there is a little bit of convenience magic built-in, which
-detects if the runtime class of the statically given actor subtype extends the
-`RequiresMessageQueue` trait via the `Stash` trait (this is a
-complicated way of saying that `new Act with Stash` would not work because its
-runtime erased type is just an anonymous subtype of `Act`). The purpose is to
-automatically use the appropriate deque-based mailbox type required by `Stash`.
-If you want to use this magic, simply extend `ActWithStash`:
-
-@@snip [ActorDSLSpec.scala]($akka$/akka-actor-tests/src/test/scala/akka/actor/ActorDSLSpec.scala) { #act-with-stash }
\ No newline at end of file
diff --git a/akka-docs/src/main/paradox/scala/index-actors.md b/akka-docs/src/main/paradox/scala/index-actors.md
index e8a6b86369..6b7db6aa6b 100644
--- a/akka-docs/src/main/paradox/scala/index-actors.md
+++ b/akka-docs/src/main/paradox/scala/index-actors.md
@@ -16,7 +16,6 @@
 * [persistence-query](persistence-query.md)
 * [persistence-query-leveldb](persistence-query-leveldb.md)
 * [testing](testing.md)
-* [actordsl](actordsl.md)
 * [typed-actors](typed-actors.md)
 
-@@@
\ No newline at end of file
+@@@