13 files changed, 60 insertions, 0 deletions
diff --git a/modules/profiles/common/default.nix b/modules/profiles/common/default.nix
index 29c74e9..36c0b45 100644
--- a/modules/profiles/common/default.nix
+++ b/modules/profiles/common/default.nix
@@ -1,3 +1,7 @@
+# modules/profiles/common/default.nix
+#
+# Configuration and tweaks that should be included in *every* system.
+
 {
   inputs,
   config,
diff --git a/modules/profiles/fstrim/default.nix b/modules/profiles/fstrim/default.nix
index c49c570..ed9eb23 100644
--- a/modules/profiles/fstrim/default.nix
+++ b/modules/profiles/fstrim/default.nix
@@ -1,3 +1,7 @@
+# modules/profiles/fstrim/default.nix
+#
+# Routinely discard unused blocks in the filesystem on supported SSDs.
+
 {
   services.fstrim = {
     enable = true;
diff --git a/modules/profiles/libvirtd/default.nix b/modules/profiles/libvirtd/default.nix
index 6802938..bd4b7af 100644
--- a/modules/profiles/libvirtd/default.nix
+++ b/modules/profiles/libvirtd/default.nix
@@ -1,3 +1,7 @@
+# modules/profiles/libvirtd/default.nix
+#
+# Enable the libvirt virtualization management system.
+
 {
   config,
   ...
diff --git a/modules/profiles/nvidia/default.nix b/modules/profiles/nvidia/default.nix
index 30c7d0c..2decd36 100644
--- a/modules/profiles/nvidia/default.nix
+++ b/modules/profiles/nvidia/default.nix
@@ -1,3 +1,7 @@
+# modules/profiles/nvidia/default.nix
+#
+# Drivers for NVIDIA cards.
+
 {
   config,
   ...
diff --git a/modules/profiles/podman/default.nix b/modules/profiles/podman/default.nix
index 267bc00..ad47257 100644
--- a/modules/profiles/podman/default.nix
+++ b/modules/profiles/podman/default.nix
@@ -1,3 +1,8 @@
+# modules/profiles/podman/default.nix
+#
+# Podman is my preferred OCI container backend. It has the added bonus of
+# supporting building and starting containers via systemd.
+
 {
   virtualisation = {
     containers.enable = true;
diff --git a/modules/profiles/steam/default.nix b/modules/profiles/steam/default.nix
index a661434..a7ed2eb 100644
--- a/modules/profiles/steam/default.nix
+++ b/modules/profiles/steam/default.nix
@@ -1,3 +1,7 @@
+# modules/profiles/steam/default.nix
+#
+# For the occasional gaming session with friends.
+
 {
   programs.steam = {
     enable = true;
diff --git a/modules/profiles/upgrade/default.nix b/modules/profiles/upgrade/default.nix
index bde99d7..e91d0ba 100644
--- a/modules/profiles/upgrade/default.nix
+++ b/modules/profiles/upgrade/default.nix
@@ -1,3 +1,8 @@
+# modules/profiles/upgrade/default.nix
+#
+# Weekly package upgrades to keep select systems up to date. A service also
+# reports server events to notify me when a system updates or restarts.
+
 {
   inputs,
   config,
diff --git a/modules/profiles/vpn/default.nix b/modules/profiles/vpn/default.nix
index e3fc316..55d0c38 100644
--- a/modules/profiles/vpn/default.nix
+++ b/modules/profiles/vpn/default.nix
@@ -1,3 +1,8 @@
+# modules/profiles/vpn/default.nix
+#
+# Sometimes I'm on scary public networks, and I don't like other people
+# sniffing my network packets.
+
 {
   pkgs,
   ...
diff --git a/modules/profiles/wireguard/default.nix b/modules/profiles/wireguard/default.nix
index ef0a6b2..4e04604 100644
--- a/modules/profiles/wireguard/default.nix
+++ b/modules/profiles/wireguard/default.nix
@@ -1,3 +1,9 @@
+# modules/profiles/wireguard/default.nix
+#
+# Although my current ISP doesn't plague me with CGNAT, I use IPv6rs with
+# wireguard to host services from home without exposing ports on my router's
+# firewall.
+
 let
   listenPort = 51820;
 in
diff --git a/modules/profiles/wireshark/default.nix b/modules/profiles/wireshark/default.nix
index 1312188..31a58cb 100644
--- a/modules/profiles/wireshark/default.nix
+++ b/modules/profiles/wireshark/default.nix
@@ -1,3 +1,7 @@
+# modules/profiles/wireshark/default.nix
+#
+# For the occasional packet sniffing and network troubleshooting.
+
 {
   config,
   pkgs,
diff --git a/modules/profiles/xorg/default.nix b/modules/profiles/xorg/default.nix
index 0917fa9..703d70e 100644
--- a/modules/profiles/xorg/default.nix
+++ b/modules/profiles/xorg/default.nix
@@ -1,3 +1,8 @@
+# modules/profiles/xorg/default.nix
+#
+# Sure X11 is "old", but xmonad doesn't yet have xorg support. I've got my eyes
+# on https://github.com/YaLTeR/niri though.
+
 {
   pkgs,
   ...
diff --git a/modules/profiles/zfs/default.nix b/modules/profiles/zfs/default.nix
index f79e91c..9a5e0a2 100644
--- a/modules/profiles/zfs/default.nix
+++ b/modules/profiles/zfs/default.nix
@@ -1,3 +1,8 @@
+# modules/profiles/zfs/default.nix
+#
+# Enabling the ZFS kernel module and configuring notifications for scrub
+# results, which are run monthly.
+
 {
   lib,
   pkgs,
diff --git a/modules/profiles/zsa/default.nix b/modules/profiles/zsa/default.nix
index d07753f..e02ee88 100644
--- a/modules/profiles/zsa/default.nix
+++ b/modules/profiles/zsa/default.nix
@@ -1,3 +1,8 @@
+# modules/profiles/zsa/default.nix
+#
+# To avoid wrist pain and mitigate the chances of RSI, I use a split keyboard at
+# home. This provides the udev rules and a utility for flashing custom firmware.
+
 {
   pkgs,
   ...