diff --git a/docs/user/config-file/v2.rst b/docs/user/config-file/v2.rst
index 89443c49271..6359ddd7437 100644
--- a/docs/user/config-file/v2.rst
+++ b/docs/user/config-file/v2.rst
@@ -487,6 +487,10 @@ The ``$READTHEDOCS_OUTPUT/html`` directory will be uploaded and hosted by Read t
 
    ``build.os`` and ``build.tools`` are also required when using ``build.commands``.
 
+.. note::
+
+   All items in the ``build.commands`` array are executed from the same initial working directory, i.e. the git repository root.
+
 :Type: ``list``
 :Required: ``false``
 :Default: ``[]``