Polish release notes for 5.7 RC1

Author: sbrannen

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

@@ -12,11 +12,11 @@
 * Java 16 support
 * Configurable default method orderer
 * Custom disabled reasons for all `@Enabled*`/`@Disabled*` annotations
-* Improvements to `assertTimeoutPreemptively`
+* Improvements to `assertTimeoutPreemptively()`
 * Improvements to `@CsvFileSource` and `@CsvSource`
 
 For a complete list of all _closed_ issues and pull requests for this release, consult the
-link:{junit5-repo}+/milestone/49?closed=1+[5.7 M2] milestone page in the JUnit repository
+link:{junit5-repo}+/milestone/49?closed=1+[5.7 RC1] milestone page in the JUnit repository
 on GitHub.
 
 
@@ -32,16 +32,18 @@ on GitHub.
 
 ==== Promoted Features
 
-* The following APIs have been promoted from "experimental":
-  - `LauncherConstants` is now "stable"
-  - `LauncherConfig` (except for methods introduced in 5.7) is now "stable"
-  - `LegacyXmlReportGeneratingListener` is now "stable"
-  - `org.junit.platform.testkit.engine` is now "maintained"
+* The following APIs have been promoted from "experimental" status:
+  - `LauncherConstants` is now _stable_
+  - `LauncherConfig` (except for methods introduced in 5.7) is now _stable_
+  - `LegacyXmlReportGeneratingListener` is now _stable_
+  - `org.junit.platform.testkit.engine` is now _maintained_
 
 ==== Bug Fixes
 
-* Characters in exception messages and other user-supplied values that are not allowed in
-  XML are now replaced with their character reference – for example, `\0` becomes `�`.
+* In XML reports generated by the `ConsoleLauncher` or
+  `LegacyXmlReportGeneratingListener`, characters in exception messages and other
+  user-supplied values that are not allowed in XML are now replaced with their character
+  reference – for example, `\0` becomes `�`.
 * The `Launcher` now throws an exception when a previously executed `TestPlan` is
   attempted to be executed again.
 
@@ -54,21 +56,20 @@ on GitHub.
 
 ==== New Features and Improvements
 
-* When using `ConsoleLauncher`, explicitly selected classes from `--select-class` and
+* When using the `ConsoleLauncher`, classes selected explicitly via `--select-class` and
   `--select-method` are now always executed regardless of class name patterns provided
-  with `--include-classname` or the default class name pattern.
+  via `--include-classname` or the default class name pattern.
 * The `ConsoleLauncher` now honors the `--disable-ansi-colors` option when printing usage
   help.
 * New `FilePosition` support in `FileSelector` and `ClasspathResourceSelector`.
-* Custom `PostDiscoveryFilter` implementations can now be registered via Java’s
-  `ServiceLoader` mechanism.
 * New `getJavaClass()` and `getJavaMethod()` methods in
   `org.junit.platform.engine.support.descriptor.MethodSource`.
-* New module `org.junit.platform.jfr` added. When running on Java 11 or later, it
-  provides and registers a `TestExecutionListener` that generates Java Flight Recorder
-  events.
-* `ExecutionRecorder` in junit-platform-testkit is now public for fine-grained testing of
-  classes that use `EngineExecutionListener`.
+* Custom `PostDiscoveryFilter` implementations can now be registered via Java’s
+  `ServiceLoader` mechanism.
+* New `org.junit.platform.jfr` module. When running on Java 11 or later, it provides and
+  registers a `TestExecutionListener` that generates Java Flight Recorder events.
+* The `ExecutionRecorder` in `junit-platform-testkit` is now public for fine-grained
+  testing of classes that use `EngineExecutionListener`.
 * `ForkJoinPoolHierarchicalTestExecutorService` can now be constructed by supplying a
   `ParallelExecutionConfiguration`.
 * `HierarchicalTestEngine` now supports a global resource lock.
@@ -79,7 +80,7 @@ on GitHub.
 
 ==== Promoted Features
 
-* The following APIs have been promoted from "experimental" to "stable":
+* The following APIs have been promoted from _experimental_ to _stable_:
   - `junit-jupiter-migrationsupport`
   - `junit-jupiter-params` (i.e. `@ParameterizedTest` etc.)
   - `@TestMethodOrder`, `MethodOrderer`, and its pre-5.7 implementations
@@ -93,13 +94,13 @@ on GitHub.
 
 ==== Bug Fixes
 
+* Inherited `@BeforeEach` methods are now executed on correct instances for `@Nested`
+  classes.
 * Registered `TestInstancePreDestroyCallback` extensions are now always called if an
   instance of a test class was created, regardless whether any registered
   `TestInstancePostProcessor` extension threw an exception.
 * Disabled `@TestTemplate` methods (e.g. `@ParameterizedTest` and `@RepeatedTest` methods)
   are now reported to registered `TestWatcher` extensions.
-* Inherited `@BeforeEach` methods are now executed on correct instances for `@Nested`
-  classes.
 
 ==== Deprecations and Breaking Changes
 
@@ -115,7 +116,7 @@ on GitHub.
 * `assertTimeoutPreemptively()` now uses threads with a specific name, conveying their use
   by the framework, to facilitate debugging and stack trace analysis.
 * All `@Enabled*`/`@Disabled*` annotations now have an optional `disabledReason` attribute
-  that can be used to provide and additional explanation as to why a test or container
+  that can be used to provide an additional explanation as to why a test or container
   might be disabled.
 * `JAVA_16` has been added to the `JRE` enum for use with JRE-based execution conditions.
 * New `MethodOrderer.MethodName` to replace `MethodOrderer.Alphanumeric` with the exact
@@ -126,16 +127,16 @@ on GitHub.
   `Iterator` for the input source.
 * `@CsvFileSource` now allows one to specify file paths as an alternative to classpath
   resources.
-* `@CsvFileSource` and `@CsvSource` now provide a `maxCharsPerColumn` attribute
-  for configuring the maximum number of characters per column.
-* Arguments in display names of parameterized test invocations are now truncated if
-  they exceed a configurable maximum length (defaults to 512 characters).
+* `@CsvFileSource` and `@CsvSource` now provide a `maxCharsPerColumn` attribute for
+  configuring the maximum number of characters per column.
+* Arguments in display names of parameterized test invocations are now truncated if they
+  exceed a configurable maximum length (defaults to 512 characters).
+* New `@Isolated` annotation allows to run test classes in isolation of other test classes
+  when using parallel test execution.
 * New `TypedArgumentConverter` for converting one specific type to another, therefore
   reducing boilerplate type checks compared to implementing `ArgumentConverter` directly.
 * New `ExtensionContext.getConfigurationParameter(String, Function<String, T>)`
   convenience method for reading transformed configuration parameters from extensions.
-* New `@Isolated` annotation allows to run test classes in isolation of other test classes
-  when using parallel test execution.
 
 
 [[release-notes-5.7.0-RC1-junit-vintage]]