diff --git a/docs/src/extensions/developing-extensions.md b/docs/src/extensions/developing-extensions.md
index a523218b43c022f5c1166d0e431ed193fdd3ef2e..97af1f2673ef7f8d8995e9cefbf0351d5b490734 100644
--- a/docs/src/extensions/developing-extensions.md
+++ b/docs/src/extensions/developing-extensions.md
@@ -120,6 +120,8 @@ git submodule add https://github.com/your-username/foobar-zed.git extensions/foo
 git add extensions/foobar
 ```
 
+> All extension submodules must use HTTPS URLs and not SSH URLS (`git@github.com`).
+
 2. Add a new entry to the top-level `extensions.toml` file containing your extension:
 
 ```toml