minor #7323 [PhpUnitBridge] clarify silencing deprecations in tests (xabbuh)

This PR was merged into the 2.7 branch.

Discussion
----------

[PhpUnitBridge] clarify silencing deprecations in tests

This resolves #7312.

Commits
-------

fe063c6 clarify silencing deprecations in tests

Author: javiereguiluz

components/phpunit_bridge.rst

@@ -94,15 +94,25 @@ in the **Unsilenced** section of the deprecation report.
 Mark Tests as Legacy
 --------------------
 
-There are four ways to mark a test as legacy:
+There are three ways to mark a test as legacy:
 
 * (**Recommended**) Add the ``@group legacy`` annotation to its class or method;
 
 * Make its class name start with the ``Legacy`` prefix;
 
-* Make its method name start with ``testLegacy*()`` instead of ``test*()``;
+* Make its method name start with ``testLegacy*()`` instead of ``test*()``.
 
-* Make its data provider start with ``provideLegacy*()`` or ``getLegacy*()``.
+.. note::
+
+    If your data provider calls code that would usually trigger a deprecation,
+    you can prefix its name with ``provideLegacy`` or ``getLegacy`` to silent
+    these deprecations. If your data provider does not execute deprecated
+    code, it is not required to choose a special naming just because the
+    test being fed by the data provider is marked as legacy.
+
+    Also be aware that choosing one of the two legacy prefixes will not mark
+    tests as legacy that make use of this data provider. You still have to
+    mark them as legacy tests explicitly.
 
 Configuration
 -------------