Document minimum required version of Maven Surefire

Author: marcphilipp

documentation/src/docs/asciidoc/release-notes/release-notes-6.0.0-M1.adoc

@@ -47,6 +47,7 @@ repository on GitHub.
   `--h` (rather than `-h`) or `-help` (rather than `--help`).
 * The `junit-platform-runner` module that provided the `JUnitPlatform` runner has been
   discontinued.
+* Support for Maven Surefire/Failsafe versions < 3.0.0 has been dropped.
 * The following deprecated APIs have been removed:
   - `ReflectionSupport.loadClass(String)` method
   - `ReflectionUtils.readFieldValue(...)` methods

documentation/src/docs/asciidoc/user-guide/running-tests.adoc

@@ -318,27 +318,9 @@ for executing tests on the JUnit Platform. The `pom.xml` file in the
 and can serve as a starting point for configuring your Maven build.
 
 [WARNING]
-.Use recent version of Maven Surefire/Failsafe to avoid interoperability issues
+.Minimum required version of Maven Surefire/Failsafe
 ====
-To avoid interoperability issues, it is recommended to use a recent version of Maven
-Surefire/Failsafe (3.0.0 or later) because it automatically aligns the version of the
-JUnit Platform Launcher that is used with the JUnit Platform version found on the test
-runtime classpath.
-
-If you are using a version older than 3.0.0-M4, you can work around the missing alignment
-by adding a test dependency on the matching version of the JUnit Platform Launcher to your
-Maven build as follows.
-
-[source,xml]
-[subs=attributes+]
-----
-<dependency>
-    <groupId>org.junit.platform</groupId>
-    <artifactId>junit-platform-launcher</artifactId>
-    <version>{version}</version>
-    <scope>test</scope>
-</dependency>
-----
+As of JUnit 6.0, the minimum required version of Maven Surefire/Failsafe is 3.0.0.
 ====
 
 [[running-tests-build-maven-bom]]

platform-tooling-support-tests/projects/maven-surefire-compatibility/pom.xml

@@ -67,17 +67,4 @@
         </repository>
     </repositories>
 
-    <profiles>
-        <profile>
-            <id>manual-platform-dependency</id>
-            <dependencies>
-                <dependency>
-                    <groupId>org.junit.platform</groupId>
-                    <artifactId>junit-platform-launcher</artifactId>
-                    <scope>test</scope>
-                </dependency>
-            </dependencies>
-        </profile>
-    </profiles>
-
 </project>

platform-tooling-support-tests/src/test/java/platform/tooling/support/tests/MavenSurefireCompatibilityTests.java

@@ -18,9 +18,8 @@
 import java.nio.file.Files;
 import java.nio.file.Path;
 
+import org.junit.jupiter.api.Test;
 import org.junit.jupiter.api.io.TempDir;
-import org.junit.jupiter.params.ParameterizedTest;
-import org.junit.jupiter.params.provider.CsvSource;
 import org.junit.platform.tests.process.OutputFiles;
 import org.opentest4j.TestAbortedException;
 
@@ -33,23 +32,19 @@
  */
 class MavenSurefireCompatibilityTests {
 
+	static final String MINIMUM_SUPPORTED_SUREFIRE_VERSION = "3.0.0";
+
 	@ManagedResource
 	LocalMavenRepo localMavenRepo;
 
-	@ParameterizedTest
-	@CsvSource(delimiter = '|', nullValues = "<none>", textBlock = """
-			2.22.2   | --activate-profiles=manual-platform-dependency
-			3.0.0-M4 | <none>
-			""")
-	void testMavenSurefireCompatibilityProject(String surefireVersion, String extraArg, @TempDir Path workspace,
-			@FilePrefix("maven") OutputFiles outputFiles) throws Exception {
-		var extraArgs = extraArg == null ? new String[0] : new String[] { extraArg };
+	@Test
+	void testMavenSurefireCompatibilityProject(@TempDir Path workspace, @FilePrefix("maven") OutputFiles outputFiles)
+			throws Exception {
 		var result = ProcessStarters.maven(Helper.getJavaHome(17).orElseThrow(TestAbortedException::new)) //
 				.workingDir(copyToWorkspace(Projects.MAVEN_SUREFIRE_COMPATIBILITY, workspace)) //
 				.addArguments(localMavenRepo.toCliArgument(), "-Dmaven.repo=" + MavenRepo.dir()) //
-				.addArguments("-Dsurefire.version=" + surefireVersion) //
+				.addArguments("-Dsurefire.version=" + MINIMUM_SUPPORTED_SUREFIRE_VERSION) //
 				.addArguments("--update-snapshots", "--batch-mode", "test") //
-				.addArguments(extraArgs) //
 				.redirectOutput(outputFiles) //
 				.startAndWait();