Merge pull request #18269 from ktoso/wip-18128-poisonpill-persistentActor-ktoso

=doc #18128 explain PoisonPill interaction with PA

akka-docs/rst/project/migration-guide-eventsourced-2.3.x.rst

@@ -72,7 +72,7 @@ Processors / PersistentActor
 
 **Akka Persistence:** ``PersistentActor``
 
-- Trait that adds journaling to actors (see :ref:`event-sourcing`) and used by applications for
+- Trait that adds journaling to actors (see :ref:`event-sourcing-scala`) and used by applications for
   *event sourcing* or *command sourcing*. Corresponds to ``Eventsourced`` processors in Eventsourced but is not a stackable trait.
 - Automatically recovers on start and re-start, by default. :ref:`recovery` can be customized or turned off by
   overriding actor life cycle hooks ``preStart`` and ``preRestart``. ``Processor`` takes care that new messages

akka-docs/rst/project/migration-guide-persistence-experimental-2.3.x-2.4.x.rst

@@ -34,7 +34,7 @@ To extend ``PersistentActor``::
       /*...*/
     }
 
-Read more about the persistent actor in the :ref:`documentation for Scala <event-sourcing>` and 
+Read more about the persistent actor in the :ref:`documentation for Scala <event-sourcing-scala>` and
 :ref:`documentation for Java <event-sourcing-java>`.
 
 Changed processorId to (abstract) persistenceId
@@ -183,7 +183,7 @@ acknowledgement from the channel is needed to guarantee safe hand-off. Therefore
 delivery is provided in a new ``AtLeastOnceDelivery`` trait that is mixed-in to the
 persistent actor on the sending side. 
 
-Read more about at-least-once delivery in the :ref:`documentation for Scala <at-least-once-delivery>` and 
+Read more about at-least-once delivery in the :ref:`documentation for Scala <at-least-once-delivery-scala>` and
 :ref:`documentation for Java <at-least-once-delivery-java>`.  
 
 Default persistence plugins