minor #14035 [Notifier] Adjust notifier documentation (jschaedl)

This PR was squashed before being merged into the master branch.

Discussion
----------

[Notifier] Adjust notifier documentation

fixes #14033

<!--

If your pull request fixes a BUG, use the oldest maintained branch that contains
the bug (see https://symfony.com/releases for the list of maintained branches).

If your pull request documents a NEW FEATURE, use the same Symfony branch where
the feature was introduced (and `master` for features of unreleased versions).

-->

Commits
-------

bc29b4c [Notifier] Adjust notifier documentation

Author: xabbuh

notifier.rst

@@ -348,7 +348,7 @@ To send a notification, autowire the
 
     use Symfony\Component\Notifier\Notification\Notification;
     use Symfony\Component\Notifier\NotifierInterface;
-    use Symfony\Component\Notifier\Recipient\AdminRecipient;
+    use Symfony\Component\Notifier\Recipient\Recipient;
 
     class InvoiceController extends AbstractController
     {
@@ -365,7 +365,7 @@ To send a notification, autowire the
                 ->content('You got a new invoice for 15 EUR.');
 
             // The receiver of the Notification
-            $recipient = new AdminRecipient(
+            $recipient = new Recipient(
                 $user->getEmail(),
                 $user->getPhonenumber()
             );
@@ -385,22 +385,23 @@ both an email and sms notification to the user.
 The default notification also has a ``content()`` and ``emoji()`` method to
 set the notification content and icon.
 
-Symfony provides three types of recipients:
+Symfony provides the following recipients:
 
 :class:`Symfony\\Component\\Notifier\\Recipient\\NoRecipient`
     This is the default and is useful when there is no need to have
     information about the receiver. For example, the browser channel uses
     the current requests's :ref:`session flashbag <flash-messages>`;
 
 :class:`Symfony\\Component\\Notifier\\Recipient\\Recipient`
-    This contains only the email address of the user and can be used for
-    messages on the email and browser channel;
-
-:class:`Symfony\\Component\\Notifier\\Recipient\\AdminRecipient`
     This can contain both email address and phonenumber of the user. This
     recipient can be used for all channels (depending on whether they are
     actually set).
 
+.. versionadded:: 5.2
+
+    The ``AdminRecipient`` class was removed in Symfony 5.2, you should use
+    ``Recipient`` instead.
+
 Configuring Channel Policies
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
@@ -515,7 +516,8 @@ very high and the recipient has a phone number::
     namespace App\Notifier;
 
     use Symfony\Component\Notifier\Notification\Notification;
-    use Symfony\Component\Notifier\Recipient\Recipient;
+    use Symfony\Component\Notifier\Recipient\RecipientInterface;
+    use Symfony\Component\Notifier\Recipient\SmsRecipientInterface;
 
     class InvoiceNotification extends Notification
     {
@@ -526,12 +528,11 @@ very high and the recipient has a phone number::
             $this->price = $price;
         }
 
-        public function getChannels(Recipient $recipient)
+        public function getChannels(RecipientInterface $recipient)
         {
             if (
                 $this->price > 10000
-                && $recipient instanceof AdminRecipient
-                && null !== $recipient->getPhone()
+                && $recipient instanceof SmsRecipientInterface
             ) {
                 return ['sms'];
             }
@@ -555,7 +556,7 @@ and its ``asChatMessage()`` method::
     use Symfony\Component\Notifier\Message\ChatMessage;
     use Symfony\Component\Notifier\Notification\ChatNotificationInterface;
     use Symfony\Component\Notifier\Notification\Notification;
-    use Symfony\Component\Notifier\Recipient\Recipient;
+    use Symfony\Component\Notifier\Recipient\SmsRecipientInterface;
 
     class InvoiceNotification extends Notification implements ChatNotificationInterface
     {
@@ -566,7 +567,7 @@ and its ``asChatMessage()`` method::
             $this->price = $price;
         }
 
-        public function asChatMessage(Recipient $recipient, string $transport = null): ?ChatMessage
+        public function asChatMessage(RecipientInterface $recipient, string $transport = null): ?ChatMessage
         {
             // Add a custom emoji if the message is sent to Slack
             if ('slack' === $transport) {