diff --git a/docs/src/development/windows.md b/docs/src/development/windows.md
index 190338e3ff..b9c0dd2477 100644
--- a/docs/src/development/windows.md
+++ b/docs/src/development/windows.md
@@ -86,3 +86,11 @@ Before reporting the issue, make sure that you have the latest rustc version wit
 ### Cargo errors claiming that a dependency is using unstable features
 
 Try `cargo clean` and `cargo build`.
+
+### `STATUS_ACCESS_VIOLATION`
+
+This error can happen if you are using the "rust-lld.exe" linker. Consider trying a different linker.
+
+If you are using a global config, consider moving the Zed repository to a nested directory and add a `.cargo/config.toml` with a custom linker config in the parent directory.
+
+See this issue for more information [#12041](https://github.com/zed-industries/zed/issues/12041)