Skip to content

Commit 1bb3f5f

Browse files
committed
docs: document Windows Developer Mode registry state
1 parent 5396574 commit 1bb3f5f

1 file changed

Lines changed: 17 additions & 2 deletions

File tree

‎CONTRIBUTING.md‎

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -161,8 +161,23 @@ target path, and `cuda-core` source builds and tests fail.
161161

162162
On native Windows, materialize the current symlink as follows:
163163

164-
1. **[Activate Developer Mode](https://learn.microsoft.com/en-us/windows/apps/get-started/enable-your-device-for-development#activate-developer-mode)**
165-
so Git can create symlinks without Administrator privileges.
164+
1. **[Activate Developer Mode](https://learn.microsoft.com/en-us/windows/advanced-settings/developer-mode)**
165+
so Git can create symlinks without Administrator privileges. Then verify
166+
that Windows recorded Developer Mode in the machine-wide registry:
167+
168+
```console
169+
$ reg.exe query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /v AllowDevelopmentWithoutDevLicense
170+
```
171+
172+
The output must show `AllowDevelopmentWithoutDevLicense` as a `REG_DWORD`
173+
with value `0x1`. If the value is missing or differs, Git may report
174+
`unable to create symlink ...: Permission denied` even when Windows Settings
175+
shows Developer Mode as enabled. In that case, run the following command
176+
once from an Administrator shell:
177+
178+
```console
179+
$ reg.exe add "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\AppModelUnlock" /v AllowDevelopmentWithoutDevLicense /t REG_DWORD /d 1 /f
180+
```
166181

167182
2. **Enable Git symlink support globally** so newly-cloned repositories inherit
168183
the setting:

0 commit comments

Comments
 (0)