diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index e2d9b5a0a..9e728d4bd 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -130,6 +130,11 @@ command in the terminal:
 
 `echo "https://${CODESPACE_NAME}-4000.githubpreview.dev"`
 
+### Note: Devcontainer on Windows
+
+If you are on Windows, make sure your git config `core.autocrlf` is off. Otherwise,
+the `\r` characters confuse asdf, which in turn fails the devcontainer build.
+
 # Reporting Bugs
 We appreciate any and all bug reports.