From d626ced41027f801f44a7bb8066fa505c0e3ad6a Mon Sep 17 00:00:00 2001
From: Brian Demers <bdemers@apache.org>
Date: Mon, 17 Jun 2024 20:38:49 -0400
Subject: [PATCH] [SUREFIRE-2249] Update doc for parameter 'properties' to
 include JUnit

The Surefire and Failsafe 'properties' field works with JUnit and TestNG

This closes #750
---
 .../plugin/surefire/AbstractSurefireMojo.java | 20 ++++++++++++++++---
 1 file changed, 17 insertions(+), 3 deletions(-)

diff --git a/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java b/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java
index f158c68d1a..664121d04b 100644
--- a/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java
+++ b/maven-surefire-common/src/main/java/org/apache/maven/plugin/surefire/AbstractSurefireMojo.java
@@ -329,9 +329,23 @@ public abstract class AbstractSurefireMojo extends AbstractMojo implements Suref
     private Map<String, String> systemPropertyVariables;
 
     /**
-     * List of properties for configuring all TestNG related configurations. This is the new preferred method of
-     * configuring TestNG.
-     *
+     * List of properties for configuring the testing provider. This is the preferred method of
+     * configuring TestNG and JUnit platform providers.<br><br>
+     * JUnit platform properties may be defined in a {@code configurationParameters} element:
+     * <pre><code>{@literal <properties>}
+     *     {@literal <configurationParameters>}
+     *         junit.jupiter.execution.parallel.enabled = true
+     *         junit.jupiter.execution.parallel.mode.default = concurrent
+     *     {@literal </configurationParameters>}
+     * {@literal </properties>}</code></pre>
+     * <br>
+     * TestNG properties may be defined as distinct element blocks:
+     * <pre><code>{@literal <properties>}
+     *     {@literal <property>}
+     *         {@literal <name>parallel</name>}
+     *         {@literal <value>methods</value>}
+     *     {@literal </property>}
+     * {@literal </properties>}</code></pre>
      * @since 2.4
      */
     @Parameter