From 78ef3d6b6e7dfe65daa1334260eaf96cb07f7997 Mon Sep 17 00:00:00 2001 From: Olivier Lamy Date: Mon, 15 Jun 2026 19:30:26 +1000 Subject: [PATCH] Magnify the home, well at least have rather than nothing :) Signed-off-by: Olivier Lamy --- src/site/markdown/index.md | 63 ++++++++++++++++++++++++++++++++++++++ src/site/site.xml | 1 + 2 files changed, 64 insertions(+) create mode 100644 src/site/markdown/index.md diff --git a/src/site/markdown/index.md b/src/site/markdown/index.md new file mode 100644 index 0000000000..2be46f6477 --- /dev/null +++ b/src/site/markdown/index.md @@ -0,0 +1,63 @@ + + +# Apache Maven Surefire + +Surefire is the test framework behind Maven's `test` and `verify` phases. It runs your unit +and integration tests, collects the results, and turns them into reports — whether you use +JUnit or TestNG. + +The project ships three Maven plugins: + +- **[Maven Surefire Plugin](maven-surefire-plugin/)** — runs your unit tests during the `test` phase. +- **[Maven Failsafe Plugin](maven-failsafe-plugin/)** — runs your integration tests during the `integration-test` and `verify` phases. +- **[Maven Surefire Report Plugin](maven-surefire-report-plugin/)** — turns test results into readable HTML reports. + +New here? Start with the [Surefire Plugin guide](maven-surefire-plugin/), or grab the latest +version from the [download page](download.html). + +## What's New + +### In development (3.6.0-M2-SNAPSHOT) + +- Your tests can now run on [JUnit 6](https://github.com/apache/maven-surefire/pull/3370). +- Relative classpath entries are [resolved correctly](https://github.com/apache/maven-surefire/pull/3333) + against the forked JVM's working directory. + +### 3.6.0-M1 + +The big one: every test framework now runs through a single, unified +[JUnit Platform provider](maven-surefire-plugin/whats-new-3-6-0.html). JUnit 5 runs natively, +and JUnit 4 and TestNG run through it too — giving you more consistent behaviour and far less +to configure. JUnit 5 tests can also run in parallel, and the JUnit 5 XML reports are tidier. + +If you're upgrading, note that 3.6.0-M1 raises the minimum versions (JUnit 4.12+, TestNG +6.14.3+) and drops the old per-framework providers. The +[What's New in 3.6.0](maven-surefire-plugin/whats-new-3-6-0.html) guide walks you through it, +and the [3.6.0-M1 release notes](https://github.com/apache/maven-surefire/releases/tag/surefire-3.6.0-M1) +list everything. + +### 3.5.6 + +- Test reports can now flag flaky tests and include timestamps for test sets and test cases. +- Debugging Failsafe tests with `maven.surefire.debug` shows the + *"Listening for transport dt_socket…"* message [on time again](https://github.com/apache/maven-surefire/issues/2613). + +See the [3.5.6 release notes](https://github.com/apache/maven-surefire/releases/tag/surefire-3.5.6) +for the full list. diff --git a/src/site/site.xml b/src/site/site.xml index 2701024021..e5b9dcb2a6 100644 --- a/src/site/site.xml +++ b/src/site/site.xml @@ -36,6 +36,7 @@ +