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 b4e35d2209d566dfb6aa6f0c01f6704cdc1df386..d6962af100d2e318e6b0610940df46a7291895cb 100644 (file)
--- a/docs/platform-versions.rst
+++ b/docs/platform-versions.rst
@@ -64,3 +64,8 @@ Platform versions
      - 1.8.3-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.
+
+