Mark module as deprecated for removal

marcphilipp · marcphilipp · commit 8178545561e7 · 2025-10-31T18:35:55.000+01:00
diff --git a/documentation/src/docs/asciidoc/release-notes/release-notes-6.0.1.adoc b/documentation/src/docs/asciidoc/release-notes/release-notes-6.0.1.adoc
@@ -40,6 +40,11 @@ repository on GitHub.
 * Fix support for test methods with the same signature as a package-private methods
   declared in super classes in different packages.
 
+[[release-notes-6.0.1-junit-jupiter-deprecations-and-breaking-changes]]
+==== Deprecations and Breaking Changes
+
+* Mark `org.junit.jupiter.migrationsupport` module descriptor as deprecated for removal.
+
 [[release-notes-6.0.1-junit-jupiter-new-features-and-improvements]]
 ==== New Features and Improvements
 
diff --git a/junit-jupiter-migrationsupport/src/main/java/module-info.java b/junit-jupiter-migrationsupport/src/main/java/module-info.java
@@ -12,7 +12,10 @@
  * Support for migrating from JUnit 4 to JUnit Jupiter.
  *
  * @since 5.0
+ * @deprecated Please migrate to the corresponding APIs and extensions provided
+ * by JUnit Jupiter.
  */
+@Deprecated(forRemoval = true)
 module org.junit.jupiter.migrationsupport {
 
 	requires static transitive org.apiguardian.api;
diff --git a/platform-tooling-support-tests/src/test/java/platform/tooling/support/tests/ModularUserGuideTests.java b/platform-tooling-support-tests/src/test/java/platform/tooling/support/tests/ModularUserGuideTests.java
@@ -44,6 +44,7 @@
 class ModularUserGuideTests {
 
 	private static final String DOCUMENTATION_MODULE_DESCRIPTOR = """
+			@SuppressWarnings("removal")
 			open module documentation {
 			  exports example.testkit; // just here to ensure documentation example sources are compiled
 
