diff --git a/doc/bugs/Symlink_support_on_Windows_10_Creators_Update_with_Developer_Mode.mdwn b/doc/bugs/Symlink_support_on_Windows_10_Creators_Update_with_Developer_Mode.mdwn new file mode 100644 index 0000000000..fd8c732567 --- /dev/null +++ b/doc/bugs/Symlink_support_on_Windows_10_Creators_Update_with_Developer_Mode.mdwn @@ -0,0 +1,22 @@ +### Please describe the problem. +Since the Win10 Creators Update, if Developer Mode is enabled, symlinks can be created without elevated privileges. During cloning of a repository with symlinks, git detects this and creates symbolic links, whereas in the past it would simply create text-like files with a path. + +When symlinks are created, git-annex breaks in many wonderful ways. The symlinks are not detected as annexed files and `git annex info` shows that no files are in the annex. + +### What steps will reproduce the problem? +On a Windows 10 machine with Creators update (v1709) and Developer mode enabled, do a `git clone` of a git-annex repository. + +### What version of git-annex are you using? On what operating system? +v6.20180112 + +### Please provide any additional information below. +Since the aforementioned Windows update (commonly referred to as Creators Update), the mklink command can be executed without requiring elevated privileges if Developer mode is enabled. +See the following two articles for some background: +- https://www.ghacks.net/2016/12/04/windows-10-creators-update-symlinks-without-elevation/ +- https://www.howtogeek.com/292914/what-is-developer-mode-in-windows-10/ + +It would seem that git detects this and does not disable symlinks as git-annex expects it to do on Windows. + +### Have you had any luck using git-annex before? (Sometimes we get tired of reading bug reports all day and a lil' positive end note does wonders) +Yes. I use it frequently on multiple platforms. +