add precisions on BOMs in platform versions doc

[integration/distribution.git] / docs / platform-versions.rst

diff --git a/docs/platform-versions.rst b/docs/platform-versions.rst
index 3286860bd6671ef1194154074c513994d0c34638..246c232d2a17846fe28fc7743ad2c33709aca31a 100644 (file)
--- a/docs/platform-versions.rst
+++ b/docs/platform-versions.rst
@@ -40,3 +40,8 @@ Platform versions
      - 1.9.0-SNAPSHOT
 
 .. note:: Most projects get their YANG Tools version via MD-SAL.
+  ${project}-artifacts are maven `bill of materials <https://howtodoinjava.com/maven/maven-bom-bill-of-materials-dependency/>`__
+  (a.k.a. bom or BOM), whose use is strongly recommended to avoid versions
+  mismatch across multiple dependencies in poms.
+
+