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 3c60c4c301209564ee5bbc74ad0ff2287553780c..4e09a96f31429196d3e297a8502ac3e8a6afa833 100644 (file)
--- a/docs/platform-versions.rst
+++ b/docs/platform-versions.rst
@@ -48,3 +48,8 @@ Platform versions
      - 1.9.1-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.
+
+