diff --git a/modules/common.nix b/modules/common.nix
index 9ce6b35..974d5a4 100644
--- a/modules/common.nix
+++ b/modules/common.nix
@@ -121,9 +121,9 @@
   # FONTS
   # --------------------------------------------------------------------------
   fonts.packages = with pkgs; [
-    # Nerd fonts - syntax changed in NixOS 25.05+
-    # Old syntax was: (nerdfonts.override { fonts = [ "JetBrainsMono" ]; })
-    # New syntax is individual packages:
+    # Nerd fonts - syntax changed in nixpkgs after 24.05
+    # If using older nixpkgs: (nerdfonts.override { fonts = [ "JetBrainsMono" ]; })
+    # Current nixpkgs-unstable uses individual packages:
     nerd-fonts.jetbrains-mono
     
     # Other fonts
diff --git a/modules/gaming.nix b/modules/gaming.nix
index 90fa093..8f1656e 100644
--- a/modules/gaming.nix
+++ b/modules/gaming.nix
@@ -85,7 +85,10 @@
   boot.kernel.sysctl = {
     # Reduce swappiness for gaming
     "vm.swappiness" = 10;
-    # Increase max map count (needed for some games)
+    # Increase max map count for games requiring many memory mappings.
+    # This value (2^31 - 6) is the maximum safe value for signed 32-bit integers.
+    # Games like Star Citizen, Hogwarts Legacy, and some Unity/Unreal titles
+    # may crash without this setting due to high mmap requirements.
     "vm.max_map_count" = 2147483642;
   };