Complete JUnit Platform release notes for 5.0.0-M1 in the User Guide

Issue: #311

Author: sbrannen

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

@@ -71,52 +71,54 @@ Platform, Jupiter, and Vintage, consult the dedicated subsections.
 * The `junit-platform-console` artifact no longer defines transitive dependencies on
   `junit-platform-runner`, `junit-jupiter-engine`, or `junit-vintage-engine`.
 * The `JUnit5` Runner has been renamed to `JUnitPlatform`.
-* `@Packages` has been renamed to `@SelectPackages`.
-* `@Classes` has been renamed to `@SelectClasses`.
-* `@UniqueIds` has been removed.
+** `@Packages` has been renamed to `@SelectPackages`.
+** `@Classes` has been renamed to `@SelectClasses`.
+** `@UniqueIds` has been removed.
 * The Gradle plugin for the JUnit Platform has been completely overhauled.
 ** The JUnit Platform Gradle plugin now requires Gradle 2.5 or higher.
 ** The `junit5Test` Gradle task has been renamed to `junitPlatformTest`.
 ** The `junit5` Gradle plugin configuration has been renamed to `junitPlatform`.
 *** `runJunit4` has been replaced by `enableStandardTestTask`.
 *** `version` has been replaced by `platformVersion`.
 ** See <<running-tests-build-gradle>> for further details.
+* XML test report generation has been overhauled.
+** XML reports now contain newlines.
+** Attributes specific to the JUnit Platform that do not align with standard attributes
+   in the de facto standard XML schema are now contained in `CDATA` blocks within the
+   `<system-out>` element.
+** XML reports now use real method names and fully qualified class names instead of
+   display names.
 * Unique ID in `TestIdentifier` is now a `String`.
 * `TestSource` is now an interface with a dedicated hierarchy consisting of
   `CompositeTestSource`, `JavaSource`, `JavaPackageSource`, `JavaClassSource`,
   `JavaMethodSource`, `UriSource`, `FileSystemSource`, `DirectorySource`, and
   `FileSource`.
-* `Filter#filter()` has been renamed to `Filter#apply()`.
+* All `DiscoverySelector` factory methods have been moved to a new `DiscoverySelectors`
+  class that serves as a centralized collection of all _select_ methods.
+* `Filter.filter()` has been renamed to `Filter.apply()`.
 * `TestTag.of()` has been renamed to `TestTag.create()`.
 * `TestDiscoveryRequest` has been renamed to `LauncherDiscoveryRequest`.
 * `TestDiscoveryRequestBuilder` has been renamed to `LauncherDiscoveryRequestBuilder`.
 * `LauncherDiscoveryRequest` is now immutable.
-* `TestDescriptor#allDescendants()` has been renamed to `TestDescriptor#getAllDescendants()`.
+* `TestDescriptor.allDescendants()` has been renamed to `TestDescriptor.getAllDescendants()`.
 * `TestEngine#discover(EngineDiscoveryRequest)` has been replaced by
   `TestEngine#discover(EngineDiscoveryRequest, UniqueId)`.
 * Introduced `ConfigurationParameters` which the `Launcher` supplies to engines via the
   `EngineDiscoveryRequest` and `ExecutionRequest`
 * The `Container` and `Leaf` abstractions have been removed from the `HierarchicalTestEngine`.
-
-////
-* Added require-engine filter to console runner
-* Added requireEngine property to gradle plugin
-* Added requiredEngine as input property to gradle plugin
-* Rename includeEngineId() to requireEngineId()
-* Support required & excluded engines in ConsoleRunner
-* Support required & excluded engines in the JUnit5 Runner
-* Use consistent include/exclude terminology for tags and engines
-* Rename requireTag[s] to includeTag[s] in Gradle plugin
-
-* Introduce DiscoverSelectors collection of select methods
-
-* Support dynamic test containers in JUnit Platform Runner
-
-* Use CDATA and newlines in XML report
-* Write non-standard platform attributes to STDOUT in XML report
-* Use real names and class names in generated XML report
-* Set encoding to UTF-8 in generated XML report
-////
+* Test engines are now permitted to be completely dynamic in nature. In other words, a
+  `TestEngine` is no longer required to create `TestDescriptor` entries during the
+  _discovery phase_; a `TestEngine` may now optionally register containers and tests
+  dynamically during the _execution phase_.
+* Include and exclude support for engines and tags has been completely revised.
+** Engines and tags can no longer be _required_ but rather _included_.
+** `ConsoleLauncher` now supports the following options: `t`/`include-tag`,
+   `T`/`exclude-tag`, `e/include-engine`, `E/exclude-engine`.
+** The Gradle plugin now supports `engines` and `tags` configuration blocks with nested
+   `include` and `exclude` entries.
+** `EngineFilter` now supports `includeEngines()` and `excludeEngines()` factory methods.
+** The `JUnitPlatform` runner now supports `@IncludeTags`, `@ExcludeTags`,
+   `@IncludeEngines`, and `@ExcludeEngines`.
 
 [[release-notes-5.0.0-m1-junit-jupiter]]
 ===== JUnit Jupiter