diff --git a/book/09-git-and-other-scms/sections/import-svn.asc b/book/09-git-and-other-scms/sections/import-svn.asc
index 323447c8f..02bdbd24c 100644
--- a/book/09-git-and-other-scms/sections/import-svn.asc
+++ b/book/09-git-and-other-scms/sections/import-svn.asc
@@ -26,6 +26,12 @@ $ svn log --xml --quiet | grep author | sort -u | \
   perl -pe 's/.*>(.*?)<.*/$1 = /'
 ----
 
+[NOTE]
+====
+If you're trying this on a Windows machine, this is the point where you'll run into trouble.
+Microsoft have provided some good advice and samples at https://docs.microsoft.com/en-us/azure/devops/repos/git/perform-migration-from-svn-to-git[].
+====
+
 That generates the log output in XML format, then keeps only the lines with author information, discards duplicates, strips out the XML tags.
 (Obviously this only works on a machine with `grep`, `sort`, and `perl` installed.)
 Then, redirect that output into your `users.txt` file so you can add the equivalent Git user data next to each entry.