diff --git a/.gitmodules b/.gitmodules
index 72eb56f5..6dac16ad 100644
--- a/.gitmodules
+++ b/.gitmodules
@@ -1,3 +1,7 @@
 [submodule "examples"]
 	path = examples
 	url = https://github.com/platformio/platformio-examples.git
+[submodule "docs"]
+	path = docs
+	url = https://github.com/platformio/platformio-docs.git
+	branch = develop
diff --git a/docs b/docs
new file mode 160000
index 00000000..4428b05c
--- /dev/null
+++ b/docs
@@ -0,0 +1 @@
+Subproject commit 4428b05c61e37f7268d28f24078ae63aa09383c3