Document BOM support in Release Notes and User Guide

Author: marcphilipp

documentation/documentation.gradle

@@ -105,6 +105,7 @@ asciidoctor {
 	attributes	'jupiter-version': project.property('version'),
 				'platform-version': project.property('platformVersion'),
 				'vintage-version': project.property('vintageVersion'),
+				'bom-version': project.property('version'),
 				'junit4-version': project.property('junit4Version'),
 				'apiguardian-version': project.property('apiGuardianVersion'),
 				'ota4j-version': project.property('ota4jVersion'),

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

@@ -10,6 +10,16 @@ link:{junit5-repo}+/milestone/22?closed=1+[5.2 M1] milestone page in the JUnit r
 on GitHub.
 
 
+[[release-notes-5.2.0-M1-overall-improvements]]
+=== Overall Improvements
+
+* 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
+coordinates.
+
+
 [[release-notes-5.2.0-M1-junit-platform]]
 === JUnit Platform
 

documentation/src/docs/asciidoc/user-guide/overview.adoc

@@ -122,6 +122,18 @@ Snapshot artifacts are deployed to Sonatype's {snapshot-repo}[snapshots reposito
     JUnit Vintage test engine implementation that allows to run vintage JUnit tests, i.e. tests
     written in the JUnit 3 or JUnit 4 style, on the new JUnit Platform.
 
+[[dependency-metadata-junit-bom]]
+==== Bill of Materials (BOM)
+
+The Bill of Materials POM provided under the following Maven coordinates can be used to
+ease dependency management when referencing multiple of the above artifacts 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].
+
+* *Group ID*: `org.junit`
+* *Artifact ID*: `junit-bom`
+* *Version*: `{bom-version}`
+
 [[dependency-metadata-dependencies]]
 ==== Dependencies
 

junit-bom/README.md

@@ -5,5 +5,5 @@ using Maven [1] or Gradle [2]. Please refer to the JUnit 5 User Guide [3] for
 details.
 
 [1] https://maven.apache.org/guides/introduction/introduction-to-dependency-mechanism.html#Importing_Dependencies
-[2] https://docs.gradle.org/4.6-rc-1/userguide/managing_transitive_dependencies.html#sec:bom_import
+[2] https://docs.gradle.org/current/userguide/managing_transitive_dependencies.html#sec:bom_import
 [3] https://junit.org/junit5/docs/current/user-guide/#dependency-metadata-junit-bom