feat: add comments

modules/darwin/core.nix

@@ -1,7 +1,16 @@
-# all the configuration options are documented here:
+
-#    https://daiderd.com/nix-darwin/manual/index.html#sec-options
 { pkgs, ... }:
 {
+  ###################################################################################
+  #
+  #  Core configuration for nix-darwin
+  #
+  #  All the configuration options are documented here:
+  #    https://daiderd.com/nix-darwin/manual/index.html#sec-options
+  #
+  ###################################################################################
+
+
   # # enable flakes globally
   nix.settings.experimental-features = [ "nix-command" "flakes" ];
 

modules/nixos/core-desktop.nix

@@ -1,6 +1,11 @@
 { lib, pkgs, ... }:
 
 {
+  ###################################################################################
+  #
+  #  NixOS's core configuration suitable for my desktop computer
+  #
+  ###################################################################################
 
   imports = [
     ./core-server.nix

modules/nixos/core-server.nix

@@ -1,6 +1,11 @@
 { lib, pkgs, ... }:
 
 {
+  ###################################################################################
+  #
+  #  NixOS's core configuration suitable for all my machines
+  #
+  ###################################################################################
 
   # for nix server, we do not need to keep too much generations
   boot.loader.systemd-boot.configurationLimit = lib.mkDefault 10;

modules/nixos/fhs-fonts.nix

@@ -1,11 +1,16 @@
-# copy from https://github.com/NixOS/nixpkgs/issues/119433#issuecomment-1326957279
-# mainly for flatpak
-# bindfs resolves all symlink, 
-# allowing all fonts to be accessed at `/usr/share/fonts`
-# without letting /nix into the sandbox.
 { config, pkgs, ... }:
 
 {
+  ###################################################################################
+  #
+  #  Copy from https://github.com/NixOS/nixpkgs/issues/119433#issuecomment-1326957279
+  #  Mainly for flatpak
+  #    1. bindfs resolves all symlink, 
+  #    2. allowing all fonts to be accessed at `/usr/share/fonts`
+  #    3. without letting /nix into the sandbox.
+  #
+  ###################################################################################
+
   system.fsPackages = [ pkgs.bindfs ];
   fileSystems =
     let

modules/nixos/hyprland.nix

@@ -2,9 +2,17 @@
 
 
 {
-  # i3wm: old and stable, only support X11
+
-  # sway: compatible with i3wm, support Wayland. do not support Nvidia GPU officially.
+  ##########################################################################################################
-  # hyprland: project starts from 2022, support Wayland, envolving fast, good looking, support Nvidia GPU.
+  #
+  #  NixOS's Configuration for Hyprland Window Manager
+  #
+  #    i3wm: old and stable, only support X11
+  #    sway: compatible with i3wm, support Wayland. do not support Nvidia GPU officially.
+  #    hyprland: project starts from 2022, support Wayland, envolving fast, good looking, support Nvidia GPU.
+  #
+  ##########################################################################################################
+
 
   environment.pathsToLink = [ "/libexec" ]; # links /libexec from derivations to /run/current-system/sw
   services.xserver = {

modules/nixos/i3.nix

@@ -1,7 +1,11 @@
 { pkgs, ... }:
 
-
 {
+  ####################################################################
+  #
+  #  NixOS's Configuration for I3 Window Manager
+  #
+  ####################################################################
 
   # i3 related options
   environment.pathsToLink = [ "/libexec" ]; # links /libexec from derivations to /run/current-system/sw

modules/nixos/remote-building.nix

@@ -1,13 +1,13 @@
 { ... }: {
 
-  ############################################
+  ####################################################################
   #
   #  NixOS's Configuration for Remote Building / Distributed Building
   #
   #  Related Docs:
   #    1. https://github.com/NixOS/nix/issues/7380
   #    2. https://nixos.wiki/wiki/Distributed_build
-  ############################################
+  ####################################################################
 
   # set local's max-job to 0 to force remote building(disable local building)
   # nix.settings.max-jobs = 0;