From 73a557581e41ab812adf2d3ca2dbb3b1569ac759 Mon Sep 17 00:00:00 2001
From: Samuel Tschiedel <mukaobr@gmail.com>
Date: Sun, 15 Sep 2024 20:55:00 -0300
Subject: [PATCH] docs: don't use tildes on dock.persistent-others examples

It no longer works on Sonoma 14.6.1, leaving a `?` instead of the
desired folder.
---
 modules/system/defaults/dock.nix | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/modules/system/defaults/dock.nix b/modules/system/defaults/dock.nix
index dc4ebcffa..0ce7993a7 100644
--- a/modules/system/defaults/dock.nix
+++ b/modules/system/defaults/dock.nix
@@ -140,9 +140,10 @@ in
     system.defaults.dock.persistent-others = mkOption {
       type = types.nullOr (types.listOf (types.either types.path types.str));
       default = null;
-      example = [ "~/Documents" "~/Downloads" ];
+      example = [ "/Users/my_user_name/Documents" "/Users/my_user_name/Downloads" ];
       description = ''
         Persistent folders in the dock.
+        Note: tilde(`~`) does not get reliably expanded.
       '';
       apply = value:
         if !(isList value)