diff --git a/documentation/ref-manual/variables.rst b/documentation/ref-manual/variables.rst
index b4c6bc957..cd88a20e0 100644
--- a/documentation/ref-manual/variables.rst
+++ b/documentation/ref-manual/variables.rst
@@ -2276,6 +2276,11 @@ system and gives an overview of their function and contents.
       ":ref:`overview-manual/concepts:application development sdk`" sections all in the
       Yocto Project Overview and Concepts Manual.

+      .. warning::
+
+         Do not confuse this variable with the similarly-named
+         :term:`DEPLOYDIR` variable.
+
    :term:`DEPLOY_DIR_DEB`
       Points to the area that the OpenEmbedded build system uses to place
       Debian packages that are ready to be used outside of the build
@@ -2366,6 +2371,11 @@ system and gives an overview of their function and contents.
       them into :term:`DEPLOY_DIR_IMAGE`
       afterwards.

+      .. warning::
+
+         Do not confuse this variable with the similarly-named
+         :term:`DEPLOY_DIR` variable.
+
    :term:`DESCRIPTION`
       The package description used by package managers. If not set,
       :term:`DESCRIPTION` takes the value of the :term:`SUMMARY`