docs(darwin): prefer comments above

modules/darwin/brew/environment.nix

···
     variables = {
       # Do not send analytic data to Homebrew
       HOMEBREW_NO_ANALYTICS = "1";
+
       # don't allow insecure redirects
       HOMEBREW_NO_INSECURE_REDIRECT = "1";
+
       # don't show emoji in the output
       HOMEBREW_NO_EMOJI = "1";
+
       # I don't need any hints because nix handles homebrew for me
       HOMEBREW_NO_ENV_HINTS = "0";
     };

modules/darwin/hardware/trackpad.nix

···
 {
   system.defaults = {
-    NSGlobalDomain."com.apple.swipescrolldirection" = false; # enable natural scrolling
+    # enable natural scrolling
+    NSGlobalDomain."com.apple.swipescrolldirection" = false;
 
     trackpad = {
-      Clicking = true; # enable tap to click
-      TrackpadRightClick = true; # enable two finger right click
-      TrackpadThreeFingerDrag = false; # enable three finger drag, disabled so I can swap workspaces with 3 fingers
+      # enable tap to click
+      Clicking = true;
+
+      # enable two finger right click
+      TrackpadRightClick = true;
+
+      # enable three finger drag, disabled so I can swap workspaces with 3 fingers
+      TrackpadThreeFingerDrag = false;
     };
   };
 }

modules/darwin/preferences/clock.nix

···
 {
   system.defaults = {
-    NSGlobalDomain.AppleICUForce24HourTime = false; # use 12 hour time
+    # use 12 hour time
+    NSGlobalDomain.AppleICUForce24HourTime = false;
 
     menuExtraClock = {
-      Show24Hour = true; # show 12 hour clock
-      IsAnalog = false; # show digital clock
-      ShowAMPM = true; # show AM/PM
+      # show 12 hour clock
+      Show24Hour = true;
+
+      # show digital clock
+      IsAnalog = false;
+
+      # show AM/PM
+      ShowAMPM = true;
 
       # Show date can imply the result of ShowDayOfMonth, ShowDayOfWeek, and ShowSeconds.
-      ShowDate = 2; # 0 = Show the date 1 = Don’t show 2 = Don’t show (hides date)
-      # ShowDayOfMonth = false; # show day of month
-      # ShowDayOfWeek = false; # show day of week
-      # ShowSeconds = false; # show seconds
+      # 0 = Show the date 1 = Don’t show 2 = Don’t show (hides date)
+      ShowDate = 2;
+
+      # show day of month
+      # ShowDayOfMonth = false;
+
+      # show day of week
+      # ShowDayOfWeek = false;
+
+      # show seconds
+      # ShowSeconds = false;
     };
   };
 }

modules/darwin/preferences/default.nix

···
     ./finder.nix # Settings for Finder (file manager)
     ./images.nix # Screensaver, screenshots etc
     ./login.nix # Settings for the login screen
+    ./measurements.nix # Units and measurements
     ./misc.nix # Miscellaneous settings
     ./sound.nix # Sound settings
     ./theme.nix # Theme settings

modules/darwin/preferences/dock.nix

···
   system.defaults = {
     dock = {
       autohide = true;
-      autohide-delay = 0.0; # autohide delay
-      autohide-time-modifier = 1.0; # autohide animation duration
+
+      # autohide delay
+      autohide-delay = 0.0;
+
+      # autohide animation duration
+      autohide-time-modifier = 1.0;
+
+      # dock position
+      orientation = "bottom";
+
+      # dock icon size
+      tilesize = 1;
 
-      orientation = "bottom"; # dock position
-      tilesize = 1; # dock icon size
+      # show running apps
+      static-only = false;
 
-      static-only = false; # show running apps
-      show-recents = false; # disable recent apps
-      showhidden = false; # show hidden apps
-      mru-spaces = false; # disable recent spaces
+      # disable recent apps
+      show-recents = false;
+
+      # show hidden apps
+      showhidden = false;
+
+      # disable recent spaces
+      mru-spaces = false;
 
       # customize Hot Corners
-      # wvous-tl-corner = 2; # top-left - Mission Control
-      # wvous-tr-corner = 13; # top-right - Lock Screen
-      # wvous-bl-corner = 3; # bottom-left - Application Windows
-      # wvous-br-corner = 4; # bottom-right - Desktop
+      #  1: Disabled
+      #  2: Mission Control
+      #  3: Application Windows
+      #  4: Desktop
+      #  5: Start Screen Saver
+      #  6: Disable Screen Saver
+      #  7: Dashboard
+      #  10: Put Display to Sleep
+      #  11: Launchpad
+      #  12: Notification Center
+      #  13: Lock Screen
+      #  14: Quick Note
+      wvous-tl-corner = 1;
+      wvous-tr-corner = 1;
+      wvous-bl-corner = 1;
+      wvous-br-corner = 1;
     };
   };
 

modules/darwin/preferences/finder.nix

···
 {
   system.defaults = {
     finder = {
-      _FXShowPosixPathInTitle = true; # show full path in finder title
-      # FXRemoveOldTrashItems = true; # remove items from trash after 30 days
-      AppleShowAllExtensions = true; # show all file extensions
-      AppleShowAllFiles = true; # show hidden files
-      FXEnableExtensionChangeWarning = false; # disable warning when changing file extension
-      QuitMenuItem = true; # hide the quit button on finder
-      ShowPathbar = true; # show path bar
-      ShowStatusBar = true; # show status bar
+      # show full path in finder title
+      _FXShowPosixPathInTitle = true;
 
-      # cusomize the desktop
-      CreateDesktop = false; # disable icons on the desktop
+      # remove items from trash after 30 days
+      # FXRemoveOldTrashItems = true;
+
+      # show all file extensions
+      AppleShowAllExtensions = true;
+
+      # show hidden files
+      AppleShowAllFiles = true;
+
+      # disable warning when changing file extension
+      FXEnableExtensionChangeWarning = false;
+
+      # hide the quit button on finder
+      QuitMenuItem = true;
+
+      # show path bar
+      ShowPathbar = true;
+
+      # show status bar
+      ShowStatusBar = true;
+
+      # disable icons on the desktop
+      CreateDesktop = false;
     };
 
     CustomUserPreferences."com.apple.finder" = {
···
       ShowMountedServersOnDesktop = true;
       ShowRemovableMediaOnDesktop = true;
       _FXSortFoldersFirst = true;
+
       # When performing a search, search the current folder by default
       FXDefaultSearchScope = "SCcf";
     };

modules/darwin/preferences/login.nix

···
 {
   system.defaults.loginwindow = {
-    GuestEnabled = false; # disable guest user
-    SHOWFULLNAME = false; # show full name in login window
+    # disable guest user
+    GuestEnabled = false;
+
+    # show full name in login window
+    SHOWFULLNAME = false;
   };
 }

modules/darwin/preferences/measurements.nix

···
+{
+  system.defaults.NSGlobalDomain = {
+    AppleMeasurementUnits = "Centimeters";
+    AppleTemperatureUnit = "Celsius";
+  };
+}

modules/darwin/preferences/misc.nix

···
 {
   system.defaults = {
     NSGlobalDomain = {
-      NSAutomaticCapitalizationEnabled = false; # disable auto capitalization
-      NSAutomaticDashSubstitutionEnabled = false; # disable auto dash substitution
-      NSAutomaticPeriodSubstitutionEnabled = false; # disable auto period substitution
-      NSAutomaticQuoteSubstitutionEnabled = false; # disable auto quote substitution
-      NSAutomaticSpellingCorrectionEnabled = false; # disable auto spelling correction
-      NSNavPanelExpandedStateForSaveMode = true; # expand save panel by default
-      NSNavPanelExpandedStateForSaveMode2 = true; # ^
+      # disable auto capitalization
+      NSAutomaticCapitalizationEnabled = false;
+
+      # disable auto dash substitution
+      NSAutomaticDashSubstitutionEnabled = false;
+
+      # disable auto period substitution
+      NSAutomaticPeriodSubstitutionEnabled = false;
+
+      # disable auto quote substitution
+      NSAutomaticQuoteSubstitutionEnabled = false;
+
+      # disable auto spelling correction
+      NSAutomaticSpellingCorrectionEnabled = false;
+
+      # expand save panel by default
+      NSNavPanelExpandedStateForSaveMode = true;
+      NSNavPanelExpandedStateForSaveMode2 = true;
     };
 
     CustomUserPreferences = {

modules/darwin/preferences/sound.nix

···
 {
   system.defaults.NSGlobalDomain = {
-    "com.apple.sound.beep.feedback" = 0; # disable beep sound when pressing volume up/down key
-    "com.apple.sound.beep.volume" = null; # disable beep sound
+    # disable beep sound when pressing volume up/down key
+    "com.apple.sound.beep.feedback" = 0;
+
+    # disable beep sound
+    "com.apple.sound.beep.volume" = null;
   };
 }

modules/darwin/preferences/theme.nix

···
-{
-  system.defaults.NSGlobalDomain.AppleInterfaceStyle = "Dark"; # dark mode
-}
+{ system.defaults.NSGlobalDomain.AppleInterfaceStyle = "Dark"; }

modules/darwin/preferences/wm.nix

···
 {
   system.defaults.CustomUserPreferences = {
-    "com.apple.spaces" = {
-      "spans-displays" = 0; # Display have separate spaces
-    };
+    # Display have separate spaces
+    "com.apple.spaces"."spans-displays" = 0;
 
     "com.apple.WindowManager" = {
-      EnableStandardClickToShowDesktop = 0; # Click wallpaper to reveal desktop
-      StandardHideDesktopIcons = 0; # Show items on desktop
-      HideDesktop = 0; # Do not hide items on desktop & stage manager
+      # Click wallpaper to reveal desktop
+      EnableStandardClickToShowDesktop = 0;
+
+      # Show items on desktop
+      StandardHideDesktopIcons = 0;
+
+      # Do not hide items on desktop & stage manager
+      HideDesktop = 0;
       StageManagerHideWidgets = 0;
       StandardHideWidgets = 0;
     };

modules/darwin/services/yabai.nix

···
   inherit (lib.modules) mkIf;
 in
 {
+  # https://github.com/koekeishiya/yabai#requirements-and-caveats
+  system.defaults = {
+    # whether to automatically rearrange spaces based on most recent use
+    dock.mru-spaces = false;
+
+    # Apple menu > System Preferences > Mission Control > Displays have separate Space
+    spaces.spans-displays = false;
+  };
+
   services.yabai = mkIf (config.garden.environment.desktop == "yabai") {
     enable = true;
     enableScriptingAddition = true;