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]