diff --git a/docs/src/developing_zed__building_zed.md b/docs/src/developing_zed__building_zed.md
index a360be8397..4ff4d37fe7 100644
--- a/docs/src/developing_zed__building_zed.md
+++ b/docs/src/developing_zed__building_zed.md
@@ -1,5 +1,13 @@
 # Building Zed
 
+## Repository
+
+After cloning the repository, ensure all git submodules are initialized:
+
+```shell
+git submodule update --init --recursive
+```
+
 ## Dependencies
 
 - Install [Rust](https://www.rust-lang.org/tools/install)