symfony
diff --git a/‎components/phpunit_bridge.rst
Copy file name to clipboardExpand all lines: components/phpunit_bridge.rst
+26Lines changed: 26 additions & 0 deletions b/‎components/phpunit_bridge.rst
Copy file name to clipboardExpand all lines: components/phpunit_bridge.rst
+26Lines changed: 26 additions & 0 deletions
@@ -128,6 +128,32 @@ The summary includes:
             <listener class="Symfony\Bridge\PhpUnit\SymfonyTestsListener"/>
         </listeners>
 
+Running Tests in Parallel
+-------------------------
+
+The modified PHPUnit script allows running tests in parallel by providing
+a directory containing multiple test suites with their own ``phpunit.xml.dist``.
+
+.. code-block:: terminal
+
+    ├── tests/
+    │   ├── Functional/
+    │   │   ├── ...
+    │   │   └── phpunit.xml.dist
+    │   ├── Unit/
+    │   │   ├── ...
+    │   │   └── phpunit.xml.dist
+
+.. code-block:: terminal
+
+    $ ./vendor/bin/simple-phpunit tests/
+
+The modified PHPUnit script will recursively go through the provided directory,
+up to a depth of 3 subfolders or the value specified by the environment variable
+``SYMFONY_PHPUNIT_MAX_DEPTH``, looking for ``phpunit.xml.dist`` files and then
+running each suite it finds in parallel, collecting their output and displaying
+each test suite results in their own section.
+
 Trigger Deprecation Notices
 ---------------------------