diff --git a/.gitattributes b/.gitattributes
new file mode 100644
index 0000000..47eb2a3
--- /dev/null
+++ b/.gitattributes
@@ -0,0 +1,6 @@
+# Shell scripts must keep LF: a CR in the shebang or in a command breaks bash on Linux.
+*.sh text eol=lf
+
+# PowerShell is happy either way, but keep the working tree native on Windows.
+*.ps1 text eol=crlf
+*.cmd text eol=crlf
diff --git a/User/README.md b/User/README.md
new file mode 100644
index 0000000..f4f334d
--- /dev/null
+++ b/User/README.md
@@ -0,0 +1,9 @@
+Settings tracked here by scripts/settings.ps1:
+
+- settings.json
+- keybindings.json
+- tasks.json
+- snippets/
+- extensions.txt (marketplace extension ids)
+
+Run `.\scripts\settings.ps1 -Push` on the machine whose setup you want to keep.