Enable -parameters

Fixes #3797.

documentation/src/docs/asciidoc/release-notes/release-notes-5.11.0-M2.adoc

@@ -10,6 +10,15 @@ link:{junit5-repo}+/milestone/74?closed=1+[5.11.0-M2] milestone page in the
 JUnit repository on GitHub.
 
 
+[[release-notes-5.11.0-M2-overall-improvements]]
+=== Overall Improvements
+
+[[release-notes-5.11.0-M2-overall-new-features-and-improvements]]
+==== New Features and Improvements
+* The shipped bytecode was compiled with the `-parameters` option of `javac` and thus now
+  contains metadata for reflection on parameters such as their names.
+
+
 [[release-notes-5.11.0-M2-junit-platform]]
 === JUnit Platform
 

gradle/plugins/common/src/main/kotlin/junitbuild.java-library-conventions.gradle.kts

@@ -238,7 +238,9 @@ tasks.compileJava {
 	// See: https://docs.oracle.com/en/java/javase/12/tools/javac.html
 	options.compilerArgs.addAll(listOf(
 			"-Xlint:all", // Enables all recommended warnings.
-			"-Werror" // Terminates compilation when warnings occur.
+			"-Werror", // Terminates compilation when warnings occur.
+			// Required for compatibility with Java 8's reflection APIs (see https://github.com/junit-team/junit5/issues/3797).
+			"-parameters", // Generates metadata for reflection on method parameters.
 	))
 }