diff --git a/.config/mise.toml b/.config/mise.toml
index b74521b4ecf..7b879e1351e 100644
--- a/.config/mise.toml
+++ b/.config/mise.toml
@@ -11,10 +11,6 @@ rust_version = "1.89"
 uv_version = "0.8.13"
 node_version = "24"
 
-[settings]
-# the default cmd doesn't support shell expansion, use PowerShell instead
-windows_default_inline_shell_args = "pwsh -Command"
-
 [tools]
 # We need cargo-binstall so that Mise would download "cargo:" tools instead of building them.
 "cargo-binstall" = "latest"
diff --git a/docs/contributing.md b/docs/contributing.md
index 7bc862a5be7..40d3ce8999d 100644
--- a/docs/contributing.md
+++ b/docs/contributing.md
@@ -474,6 +474,15 @@ the configuration file at `.config/mise.toml`.
 You can customize this configuration using
 [a `mise.local.toml` file](https://mise.jdx.dev/configuration.html#mise-toml).
 
+On Windows, some tasks use shell expansion, which the default `cmd /c` doesn't
+support. `mise` only honors the shell settings from your global configuration,
+so set this in `~/.config/mise/config.toml` to run tasks with PowerShell:
+
+```toml
+[settings]
+windows_default_inline_shell_args = "pwsh -Command"
+```
+
 ## Previewing the HTML documentation
 
 The documentation for `jj` is automatically published online at