diff --git a/docs/reference/tooltips.md b/docs/reference/tooltips.md
index d1dc583c376..4f89c299170 100644
--- a/docs/reference/tooltips.md
+++ b/docs/reference/tooltips.md
@@ -155,3 +155,14 @@ pages with the following configuration:
     ````
 
   [auto-append]: https://facelessuser.github.io/pymdown-extensions/extensions/snippets/#auto-append-snippets
+
+!!! tip
+
+    When using a dedicated file outside of the `docs` folder, add the parent directory to the list
+    of `watch` folders so that when the glossary file is updated, the project is automatically
+    reloaded when running `mkdocs serve`.
+
+    ```` yaml
+    watch:
+      - includes
+    ````