style: align comments with the project conventions

Apply a codebase-wide comment audit against the comment conventions:
split banned semicolons and multi-sentence lines into one sentence per
line, cut cross-file and history narration, trim file-top headers to a
single purpose line, and drop verbosity that did not earn its place.
Prose docs (CLAUDE.md, install.md) get the same one-sentence-per-line
and no-semicolon treatment.

modules/desktop/hyprland/hypridle.nix

@@ -4,8 +4,7 @@
   pkgs,
   ...
 }:
-# Idle management: hypridle locks on idle, powers the displays off, and locks
-# before every suspend, so an unattended session always lands at hyprlock.
+# hypridle: idle-triggered locking and display power management.
 let
   cfg = config.modules.desktop.hyprland.hypridle;
   user = config.user.name;

modules/desktop/hyprland/hyprland.nix

@@ -4,7 +4,7 @@
   pkgs,
   ...
 }:
-# The Hyprland compositor, sourced from nixpkgs.
+# The Hyprland compositor.
 let
   cfg = config.modules.desktop.hyprland;
   user = config.user.name;
@@ -63,12 +63,13 @@ in
         "$mod" = "SUPER";
         "$terminal" = "alacritty";
 
-        # Hand the cursor theme to the compositor directly. UWSM launches the
-        # session without the shell profile that carries the pointer-cursor
-        # variables, so without this Hyprland never sees a theme and falls back
-        # to its built-in cursor. Bibata ships XCursor only; the hyprcursor
-        # variables name the same theme, which Hyprland resolves through its
-        # XCursor fallback.
+        # Hand the cursor theme to the compositor directly.
+        # UWSM launches the session without the shell profile that carries the
+        # pointer-cursor variables, so without this Hyprland never sees a theme
+        # and falls back to its built-in cursor.
+        # Bibata ships XCursor only.
+        # The hyprcursor variables name the same theme, which Hyprland resolves
+        # through its XCursor fallback.
         env = lib.optionals (cursor != null) [
           "XCURSOR_THEME,${cursor.name}"
           "XCURSOR_SIZE,${toString cursor.size}"
@@ -81,7 +82,7 @@ in
           # Caps is a second Escape.
           # Shift+Caps still toggles a real CapsLock.
           kb_options = "caps:escape_shifted_capslock";
-          # Snappy: a short delay before repeat begins, then a fast repeat rate.
+          # Snappy key repeat.
           repeat_delay = 250;
           repeat_rate = 45;
           accel_profile = "flat";
@@ -156,8 +157,9 @@ in
         ++ workspaceBinds;
 
         # Volume and brightness keys repeat while held, each raising a popup
-        # through the OSD client. Volume is capped at 100 percent; the client
-        # floors brightness so a full hold cannot black the screen out.
+        # through the OSD client.
+        # Volume is capped at 100 percent.
+        # The client floors brightness so a full hold cannot black the screen out.
         binde = [
           ", XF86AudioRaiseVolume, exec, ${pkgs.swayosd}/bin/swayosd-client --output-volume raise --max-volume 100"
           ", XF86AudioLowerVolume, exec, ${pkgs.swayosd}/bin/swayosd-client --output-volume lower"

modules/desktop/hyprland/hyprlock.nix

@@ -4,13 +4,12 @@
   pkgs,
   ...
 }:
-# The lock screen: hyprlock, a session-lock client whose surface the compositor owns, so it survives a crash of the locker rather than exposing the session.
+# The lock screen: a hyprlock session-lock surface the compositor owns.
 let
   cfg = config.modules.desktop.hyprland.hyprlock;
   user = config.user.name;
 
-  # The hyprlock this module installs, so the keybind and the idle daemon lock
-  # with one package and never split versions.
+  # The hyprlock this module installs, used by the lock keybind below.
   hyprlock = "${config.home-manager.users.${user}.programs.hyprlock.package}/bin/hyprlock";
 in
 {
@@ -30,7 +29,8 @@ in
             disable_loading_bar = true;
           };
 
-          # A centered password field; its colors are the Stylix target's.
+          # A centered password field.
+          # Its colors come from the Stylix hyprlock target.
           input-field = {
             size = "260, 52";
             rounding = 8;