Deprecate cucumber-junit in favour of cucumber-junit-platform-engine (#3016)

With JUnit 4 in maintenance mode and JUnit vintage being deprecated
support for JUnit 4 is winding down. As such users should be encouraged
to migrate away from JUnit 4 and `cucumber-junit` onto JUnit 5 with the
`cucumber-junit-platform-engine`.

Author: mpkorstanje

CHANGELOG.md

@@ -22,6 +22,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Fixed
 - [JUnit Platform Engine] Log discovery issues for feature files with parse errors. ([#2835](https://github.com/cucumber/cucumber-jvm/pull/2835) M.P. Korstanje)
 
+### Deprecated
+- [JUnit] Deprecate `cucumber-junit` in favour of `cucumber-junit-platform-engine` ([#2835](https://github.com/cucumber/cucumber-jvm/pull/3016) M.P. Korstanje)
 
 ## [7.23.0] - 2025-05-29
 ### Added

cucumber-junit/README.md

@@ -1,7 +1,9 @@
-Cucumber JUnit 
-==============
+Cucumber JUnit (Deprecated)
+===========================
 
-_For JUnit 5 use the [Cucumber JUnit Platform Engine](../cucumber-junit-platform-engine)_
+> [!IMPORTANT]  
+> **JUnit 4 is in maintenance mode.**  
+> For JUnit 5 use the [Cucumber JUnit Platform Engine](../cucumber-junit-platform-engine)
 
 Use JUnit 4 to execute Cucumber scenarios. To use add the `cucumber-junit`
 dependency to your pom.xml:

cucumber-junit/src/main/java/io/cucumber/junit/Cucumber.java

@@ -84,8 +84,11 @@
  * commandline, IntelliJ IDEA or Cucumber-Eclipse. Instead it is recommended to
  * use Cucumbers `Before` and `After` hooks.
  *
- * @see CucumberOptions
+ * @see        CucumberOptions
+ * @deprecated JUnit 4 is in maintenance mode. Upgrade to JUnit 5 and switch to
+ *             the {@code cucumber-junit-platform-engine}.
  */
+@Deprecated
 @API(status = API.Status.STABLE)
 public final class Cucumber extends ParentRunner<ParentRunner<?>> {
 

cucumber-junit/src/main/java/io/cucumber/junit/CucumberOptions.java

@@ -10,7 +10,11 @@
 
 /**
  * Configure Cucumbers options.
+ * 
+ * @deprecated JUnit 4 is in maintenance mode. Upgrade to JUnit 5 and switch to
+ *             the {@code cucumber-junit-platform-engine}.
  */
+@Deprecated
 @Retention(RetentionPolicy.RUNTIME)
 @Target({ ElementType.TYPE })
 @API(status = API.Status.STABLE)