Added "See also"

I shortened the example, cause `$emails[0]->getTo()[0];` looks strange ;-) Instead, I added the "See also"-links which (I think) are a good idea in general since the page gets longer and longer, so it's harder to get an overview what functions do exist at all...

The `@var` annotation syntax is taken from https://phpstan.org/writing-php-code/phpdoc-types#general-arrays - I'm not 100% sure if this is the right way.

The closing `*/` in my new `@var` line might break the page rendering completely ;-) (same as in Codeception#119) - is there a way to escape this?

Author: ThomasLandauer

src/Codeception/Module/Symfony/MailerAssertionsTrait.php

@@ -39,6 +39,7 @@ public function seeEmailIsSent(int $expectedCount = 1): void
 
     /**
      * Returns the last sent email.
+     * See also: [grabSentEmails()](https://codeception.com/docs/modules/Symfony#grabSentEmails)
      *
      * ```php
      * <?php
@@ -61,12 +62,12 @@ public function grabLastSentEmail(): ?Email
 
     /**
      * Returns an array of all sent emails.
+     * See also: [grabLastSentEmail()](https://codeception.com/docs/modules/Symfony#grabLastSentEmail).
      *
      * ```php
      * <?php
+     * /** @var array<int, \Symfony\Component\Mime\Email> $emails */
      * $emails = $I->grabSentEmails();
-     * $address = $emails[0]->getTo()[0];
-     * $I->assertSame('john_doe@user.com', $address->getAddress());
      * ```
      *
      * @return \Symfony\Component\Mime\Email[]
@@ -90,4 +91,4 @@ protected function getMessageMailerEvents(): MessageEvents
 
         $this->fail("Emails can't be tested without Symfony Mailer service.");
     }
-}
+}