[Testing] Documented the changes in MailerAssertionsTrait

Author: javiereguiluz

testing/functional_tests_assertions.rst

@@ -19,17 +19,17 @@ Now here is the example with the assertions specific to Symfony::
 
     $this->assertSelectorTextContains('html', 'Hello World');
 
-.. note::
-
-    These assertions only work if a request has been made with the ``Client``
-    in a test case extending the ``WebTestCase`` class.
-
 Assertions Reference
 ---------------------
 
 Response
 ~~~~~~~~
 
+.. note::
+
+    The following assertions only work if a request has been made with the
+    ``Client`` in a test case extending the ``WebTestCase`` class.
+
 - ``assertResponseIsSuccessful()``
 - ``assertResponseStatusCodeSame()``
 - ``assertResponseRedirects()``
@@ -44,12 +44,22 @@ Response
 Request
 ~~~~~~~
 
+.. note::
+
+    The following assertions only work if a request has been made with the
+    ``Client`` in a test case extending the ``WebTestCase`` class.
+
 - ``assertRequestAttributeValueSame()``
 - ``assertRouteSame()``
 
 Browser
 ~~~~~~~
 
+.. note::
+
+    The following assertions only work if a request has been made with the
+    ``Client`` in a test case extending the ``WebTestCase`` class.
+
 - ``assertBrowserHasCookie()``
 - ``assertBrowserNotHasCookie()``
 - ``assertBrowserCookieValueSame()``
@@ -59,8 +69,9 @@ Crawler
 
 .. note::
 
-    You cannot use the :doc:`Crawler </components/dom_crawler>` assertions,
-    when using `symfony/panther`_ for end-to-end testing.
+    The following assertions only work if a request has been made with the
+    ``Client`` in a test case extending the ``WebTestCase`` class. They are not
+    available either when using `symfony/panther`_ for end-to-end testing.
 
 - ``assertSelectorExists()``
 - ``assertSelectorNotExists()``
@@ -75,6 +86,11 @@ Crawler
 Mailer
 ~~~~~~
 
+.. versionadded:: 5.1
+
+    Starting from Symfony 5.1, the following assertions no longer require to make
+    a request with the ``Client`` in a test case extending the ``WebTestCase`` class.
+
 - ``assertEmailCount()``
 - ``assertQueuedEmailCount()``
 - ``assertEmailIsQueued()``