diff --git a/flake.nix b/flake.nix
index 3ff12f3..b8cc3b4 100644
--- a/flake.nix
+++ b/flake.nix
@@ -77,6 +77,10 @@
       };
 
       darwinConfigurations = mkSystem {
+        # NOTE: home manager activation is showing following error
+        # error: profile '/Users/william/.local/state/nix/profiles/profile' is incompatible with 'nix-env'; please use 'nix profile' instead
+        # temporary workaround is to synlink ~/.local/state/nix/profile to ~/.nix-profile
+        # ref: https://discourse.nixos.org/t/home-manager-insists-on-using-nix-profile/57708
         isDarwin = true;
       };
 
diff --git a/lib/nix.nix b/lib/nix.nix
index f08a6b2..1ccb3eb 100644
--- a/lib/nix.nix
+++ b/lib/nix.nix
@@ -17,6 +17,7 @@ in
       auto-optimise-store = !pkgs.stdenv.isDarwin;
 
       # add these to global /etc/nix/nix.conf when using home manager, and restart nix-daemon by `systemctl restart nix-daemon`
+      # nix-daemon doesn't watch the nix.conf file: https://github.com/NixOS/nix/issues/8939
       trusted-users = [
         "root"
         "@wheel"