From ce50d99cc0daa1dbb3df18b66a5b6641e557d3e2 Mon Sep 17 00:00:00 2001
From: Felix Schneider <99918022+trueberryless@users.noreply.github.com>
Date: Fri, 19 Sep 2025 09:37:53 +0200
Subject: [PATCH] docs: alias mistake

---
 README.md | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/README.md b/README.md
index 3454655..5163879 100644
--- a/README.md
+++ b/README.md
@@ -24,6 +24,8 @@ sudo darwin-rebuild switch --flake ~/.config/nix
 
 ## Troubleshooting
 
+### dotfiles
+
 If your home-manager configuration files are not getting applied, the issue could be some messed up permissions of your `.local` folder, check them with:
 
 ```bash
@@ -36,6 +38,10 @@ If those are not owned by **you** but maybe **root** instead, change the permiss
 sudo chown -R trueberryless:staff ~/.local
 ```
 
+### alias
+
+Be careful which user runs commands and which config file these users will use to get available aliases. For example, the `nix-switch` alias [in this repo](/modules/sudo-alias.nix) allows the root user to run the alias, as it uses the `$SUDO_USER` to find the folder of the user which executes the command (in this case `trueberryless`). It is not possible to simply define aliases for root inside [`home-manager.nix`](/modules/home-manager.nix) as the sudo user uses a different `.zshrc` file.
+
 ## Resources
 
 - [Determinate Systems][determinate-systems]: [installer-repo][installer-repo], [Zero to Nix][zero-to-nix]
-- 
2.51.2