Prepare 5.2.0-M1 Release Notes

Author: sbrannen

documentation/src/docs/asciidoc/release-notes/release-notes-5.2.0-M1.adoc

@@ -1,9 +1,12 @@
 [[release-notes-5.2.0-M1]]
 == 5.2.0-M1
 
-*Date of Release:* ❓
+*Date of Release:* April 15, 2018
 
-*Scope:* ❓
+*Scope:* JUnit BOM, support for Maven Surefire 2.21.0 allowing builds with Java 9 and
+Java 10, _argument aggregation_ and _widening primitive conversion_ for arguments in
+parameterized tests, external factory methods for `@MethodSource`, as well as various
+minor improvements and bug fixes.
 
 For a complete list of all _closed_ issues and pull requests for this release, consult the
 link:{junit5-repo}+/milestone/22?closed=1+[5.2 M1] milestone page in the JUnit repository
@@ -16,7 +19,7 @@ on GitHub.
 * JUnit BOM: To ease dependency management using
 https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Importing_Dependencies[Maven]
 or https://docs.gradle.org/current/userguide/managing_transitive_dependencies.html#sec:bom_import[Gradle],
-a Bill of Materials POM is now provided under the `org.junit:junit-bom:5.2.0-M1` Maven
+a _Bill of Materials_ POM is now provided under the `org.junit:junit-bom:5.2.0-M1` Maven
 coordinates.
 
 
@@ -27,13 +30,14 @@ coordinates.
 
 * Tag expressions containing spaces are now supported in the JUnit Platform Maven
   Surefire provider.
-
-==== Deprecations and Breaking Changes
-
-* ❓
+* Duplicate `--config` keys supplied to the `ConsoleLauncher` are now reported properly.
+* Exceptions thrown in `Node.after()` (in the `HierarchicalTestEngine` infrastructure) no
+  longer mask earlier exceptions.
 
 ==== New Features and Improvements
 
+* The JUnit Platform Surefire Provider (`junit-platform-surefire-provider`) now works
+  with and requires Surefire `2.21.0` which allows it to be used with Java 9 and Java 10.
 * The default _include pattern_ for filtering class names now matches test classes whose
   names either start with `Test` or end with `Test` or `Tests`.
   - This pattern is used by the `ConsoleLauncher`, the JUnit Platform Gradle Plugin, and
@@ -45,11 +49,8 @@ coordinates.
 
 ==== Bug Fixes
 
-* ❓
-
-==== Deprecations and Breaking Changes
-
-* ❓
+* Exceptions thrown by an `AfterAllCallback` no longer mask exceptions thrown at the
+  class level when using the `@TestInstance(PER_CLASS)` lifecycle mode.
 
 ==== New Features and Improvements
 
@@ -72,14 +73,4 @@ coordinates.
 [[release-notes-5.2.0-M1-junit-vintage]]
 === JUnit Vintage
 
-==== Bug Fixes
-
-* ❓
-
-==== Deprecations and Breaking Changes
-
-* ❓
-
-==== New Features and Improvements
-
-* ❓
+No changes.