From d761c0ce89d297686cefc2e5655e62fc22019372 Mon Sep 17 00:00:00 2001
From: Austin Horstman <khaneliman12@gmail.com>
Date: Sat, 27 Dec 2025 13:33:52 -0600
Subject: [PATCH] news: add zsh dotDir default change

Default has changed to respect `xdg.enable`. Let user's know in case it
affects them surprisingly.

Signed-off-by: Austin Horstman <khaneliman12@gmail.com>
---
 .../misc/news/2025/12/2025-12-27_13-32-14.nix | 20 +++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 modules/misc/news/2025/12/2025-12-27_13-32-14.nix

diff --git a/modules/misc/news/2025/12/2025-12-27_13-32-14.nix b/modules/misc/news/2025/12/2025-12-27_13-32-14.nix
new file mode 100644
index 000000000..b8b9d9c01
--- /dev/null
+++ b/modules/misc/news/2025/12/2025-12-27_13-32-14.nix
@@ -0,0 +1,20 @@
+{ config, ... }:
+{
+  time = "2025-12-27T19:00:00+00:00";
+  condition = config.programs.zsh.enable;
+
+  message = ''
+    The default value of `programs.zsh.dotDir` has changed.
+
+    When `home.stateVersion` is set to "26.05" or later, and `xdg.enable` is
+    `true` (the default), `programs.zsh.dotDir` now defaults to
+    `''${config.xdg.configHome}/zsh`. Previously, it defaulted to the home
+    directory.
+
+    This means your Zsh configuration files (`.zshrc`, `.zshenv`, etc.) will be
+    moved to `~/.config/zsh` (or your configured XDG config home).
+
+    If you prefer the old behavior, you can explicitly set:
+    `programs.zsh.dotDir = config.home.homeDirectory;`
+  '';
+}