diff --git a/documentation/ref-manual/ref-variables.xml b/documentation/ref-manual/ref-variables.xml
index facf2edb68..0383dadd5d 100644
--- a/documentation/ref-manual/ref-variables.xml
+++ b/documentation/ref-manual/ref-variables.xml
@@ -4925,12 +4925,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     Use of this variable is one mechanism to remove dependencies
                     that affect task signatures and thus force rebuilds when a
                     recipe changes.
-                    <caution>
+                    <note><title>Caution</title>
                         If you add an inappropriate dependency for a recipe
                         relationship, the software might break during
                         runtime if the interface of the second recipe was
                         changed after the first recipe had been built.
-                    </caution>
+                    </note>
                 </para>
             </glossdef>
         </glossentry>
@@ -4945,12 +4945,12 @@ recipes-graphics/xorg-font/font-alias_1.0.3.bb:PR = "${INC_PR}.3"
                     Use of this variable is one way to remove dependencies from
                     one recipe on another that affect task signatures and
                     thus force rebuilds when the recipe changes.
-                    <caution>
+                    <note><title>Caution</title>
                         If you add an inappropriate variable to this list,
                         the software might break at runtime if the
                         interface of the recipe was changed after the other
                         had been built.
-                    </caution>
+                    </note>
                 </para>
             </glossdef>
         </glossentry>