diff --git a/docs/requirements.txt b/docs/requirements.txt
deleted file mode 100644
index 2e0bc6cdc9..0000000000
--- a/docs/requirements.txt
+++ /dev/null
@@ -1 +0,0 @@
-esp-docs~=1.1.0
diff --git a/tools/requirements.json b/tools/requirements.json
index df1993c7b3..bfc09a428c 100644
--- a/tools/requirements.json
+++ b/tools/requirements.json
@@ -18,6 +18,12 @@
             "description": "Packages for CI with pytest",
             "optional": true,
             "requirement_path": "tools/requirements/requirements.pytest.txt"
+        },
+        {
+            "name": "docs",
+            "description": "Packages for building ESP-IDF documentation",
+            "optional": true,
+            "requirement_path": "tools/requirements/requirements.docs.txt"
         }
     ]
 }
diff --git a/tools/requirements/requirements.docs.txt b/tools/requirements/requirements.docs.txt
new file mode 100644
index 0000000000..17534adfe3
--- /dev/null
+++ b/tools/requirements/requirements.docs.txt
@@ -0,0 +1,4 @@
+# Python package requirements for building the documentation of ESP-IDF.
+# This feature can be enabled by running "install.{sh,bat,ps1,fish} --enable-docs"
+
+esp-docs