Polishing

Author: sbrannen

documentation/src/docs/asciidoc/release-notes/release-notes-5.5.0-RC1.adoc

@@ -99,5 +99,5 @@ on GitHub.
 
 * `junit:junit` is now a compile-scoped dependency of `junit-vintage-engine` to allow for
   easier dependency management in Maven POMs.
-* Methods that are `public` are now preferred over other methods with the same name in the
-  same test class when creating `MethodSources` for JUnit 4 `Descriptions`.
+* A method that is `public` is now preferred over other methods with the same name in the
+  same test class when creating a `MethodSource` for a JUnit 4 `Description`.

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

@@ -1739,8 +1739,9 @@ junit.jupiter.execution.parallel.mode.default = concurrent
 junit.jupiter.execution.parallel.mode.classes.default = same_thread
 ----
 
-Not configuring a value for `junit.jupiter.execution.parallel.mode.classes.default` is
-equivalent to using the same value as for `junit.jupiter.execution.parallel.mode.default`.
+If the `junit.jupiter.execution.parallel.mode.classes.default` configuration parameter is
+not explicitly set, the value for `junit.jupiter.execution.parallel.mode.default` will be
+used instead.
 
 [[writing-tests-parallel-execution-config]]
 ==== Configuration

junit-jupiter-engine/src/main/java/org/junit/jupiter/engine/Constants.java

@@ -165,7 +165,7 @@ public final class Constants {
 	 * <p>Supported values include names of enum constants defined in
 	 * {@link org.junit.jupiter.api.parallel.ExecutionMode}, ignoring case.
 	 *
-	 * <p>If not specified, it will be resolve into the same value as
+	 * <p>If not specified, it will be resolved into the same value as
 	 * {@link #DEFAULT_PARALLEL_EXECUTION_MODE}.
 	 *
 	 * @see org.junit.jupiter.api.parallel.Execution
@@ -194,7 +194,7 @@ public final class Constants {
 	 * Property name used to set the desired parallelism for the {@code fixed}
 	 * configuration strategy: {@value}
 	 *
-	 * <p>No default value; must be an integer.
+	 * <p>No default value; must be a positive integer.
 	 *
 	 * @since 5.3
 	 */
@@ -207,7 +207,7 @@ public final class Constants {
 	 * available processors/cores to determine the desired parallelism for the
 	 * {@code dynamic} configuration strategy: {@value}
 	 *
-	 * <p>Value must be a decimal number; defaults to {@code 1}.
+	 * <p>Value must be a positive decimal number; defaults to {@code 1}.
 	 *
 	 * @since 5.3
 	 */
@@ -232,7 +232,7 @@ public final class Constants {
 	 *
 	 * <p>The value of this property will be used unless overridden by a more
 	 * specific property or a {@link org.junit.jupiter.api.Timeout @Timeout}
-	 * annotation present on the method or an enclosing test class (for testable
+	 * annotation present on the method or on an enclosing test class (for testable
 	 * methods).
 	 *
 	 * <p>Please refer to the <a href="#supported-values-timeouts">class
@@ -249,7 +249,7 @@ public final class Constants {
 	 *
 	 * <p>The value of this property will be used unless overridden by a more
 	 * specific property or a {@link org.junit.jupiter.api.Timeout @Timeout}
-	 * annotation present on the testable method or an enclosing test class.
+	 * annotation present on the testable method or on an enclosing test class.
 	 *
 	 * <p>This property overrides the {@value #DEFAULT_TIMEOUT_PROPERTY_NAME}
 	 * property.
@@ -269,7 +269,7 @@ public final class Constants {
 	 *
 	 * <p>The value of this property will be used unless overridden by a
 	 * {@link org.junit.jupiter.api.Timeout @Timeout} annotation present on the
-	 * {@link org.junit.jupiter.api.Test @Test} method or an enclosing test
+	 * {@link org.junit.jupiter.api.Test @Test} method or on an enclosing test
 	 * class.
 	 *
 	 * <p>This property overrides the
@@ -290,7 +290,7 @@ public final class Constants {
 	 *
 	 * <p>The value of this property will be used unless overridden by a
 	 * {@link org.junit.jupiter.api.Timeout @Timeout} annotation present on the
-	 * {@link org.junit.jupiter.api.TestTemplate @TestTemplate} method or an
+	 * {@link org.junit.jupiter.api.TestTemplate @TestTemplate} method or on an
 	 * enclosing test class.
 	 *
 	 * <p>This property overrides the
@@ -311,7 +311,7 @@ public final class Constants {
 	 *
 	 * <p>The value of this property will be used unless overridden by a
 	 * {@link org.junit.jupiter.api.Timeout @Timeout} annotation present on the
-	 * {@link org.junit.jupiter.api.TestFactory @TestFactory} method or an
+	 * {@link org.junit.jupiter.api.TestFactory @TestFactory} method or on an
 	 * enclosing test class.
 	 *
 	 * <p>This property overrides the