diff --git a/docs/settings.txt b/docs/settings.txt
index 40ae452275..626106245e 100644
--- a/docs/settings.txt
+++ b/docs/settings.txt
@@ -584,8 +584,10 @@ TEMPLATE_DIRS
 
 Default: ``()`` (Empty tuple)
 
-List of locations of the template source files, in search order. See the
-`template documentation`_.
+List of locations of the template source files, in search order. Note that
+these paths should use Unix-style forward slashes, even on Windows.
+
+See the `template documentation`_.
 
 TEMPLATE_FILE_EXTENSION
 -----------------------
diff --git a/docs/templates_python.txt b/docs/templates_python.txt
index 11ff5919c5..0d2d3717bb 100644
--- a/docs/templates_python.txt
+++ b/docs/templates_python.txt
@@ -382,6 +382,8 @@ that contain full paths to your template directory(ies). Example::
         "/home/html/templates/default",
     )
 
+Note that these paths should use Unix-style forward slashes, even on Windows.
+
 The Python API
 ~~~~~~~~~~~~~~