Added more documentation comments

21 files changed, 21 insertions, 0 deletions

diff --git a/modules/desktop/default.nix b/modules/desktop/default.nix
index 5926913..18dc6a4 100644
--- a/modules/desktop/default.nix
+++ b/modules/desktop/default.nix
@@ -4,6 +4,7 @@
   ...
 }:
 
+# Desktop - Desktop environment configuration (i3, GTK, polybar)
 {
   imports = [
     ./i3
diff --git a/modules/desktop/gtk/default.nix b/modules/desktop/gtk/default.nix
index 4b89d3d..af33196 100644
--- a/modules/desktop/gtk/default.nix
+++ b/modules/desktop/gtk/default.nix
@@ -5,6 +5,7 @@
   ...
 }:
 
+# GTK - GTK3/GTK4 theme configuration (Nightfox dark theme)
 {
   config = lib.mkIf config.desktop.enable {
     gtk = {
diff --git a/modules/desktop/i3/default.nix b/modules/desktop/i3/default.nix
index fa51ab9..ed29e91 100644
--- a/modules/desktop/i3/default.nix
+++ b/modules/desktop/i3/default.nix
@@ -5,6 +5,7 @@
   ...
 }:
 
+# i3 - Window manager configuration (gaps, colors, startup, keybindings)
 {
   config = lib.mkIf config.desktop.enable {
     xsession.windowManager.i3 = {
diff --git a/modules/desktop/i3/keybindings.nix b/modules/desktop/i3/keybindings.nix
index 9d6e668..6933979 100644
--- a/modules/desktop/i3/keybindings.nix
+++ b/modules/desktop/i3/keybindings.nix
@@ -4,6 +4,7 @@
   config,
 }:
 
+# Keybindings - i3 keyboard shortcuts (app launchers, vim directions, workspaces)
 let
   mod = "Mod4";
 in
diff --git a/modules/desktop/polybar/bar/default.nix b/modules/desktop/polybar/bar/default.nix
index ce6db3b..44498c3 100644
--- a/modules/desktop/polybar/bar/default.nix
+++ b/modules/desktop/polybar/bar/default.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Bar - Polybar bar definitions (main bar)
 {
   "bar/main" = import ./main.nix { inherit config; };
 }
diff --git a/modules/desktop/polybar/bar/main.nix b/modules/desktop/polybar/bar/main.nix
index e05d9b4..93edf90 100644
--- a/modules/desktop/polybar/bar/main.nix
+++ b/modules/desktop/polybar/bar/main.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Main - Main polybar bar configuration (dimensions, colors, modules)
 with config.scheme.withHashtag;
 let
   largerFontSize = toString (builtins.ceil (config.fonts.size * 9.0 / 8.0));
diff --git a/modules/desktop/polybar/default.nix b/modules/desktop/polybar/default.nix
index a07c0c6..c52377c 100644
--- a/modules/desktop/polybar/default.nix
+++ b/modules/desktop/polybar/default.nix
@@ -5,6 +5,7 @@
   ...
 }:
 
+# Polybar - Status bar configuration (i3 integration, modules)
 {
   config = lib.mkIf config.desktop.enable {
     services.polybar.enable = true;
diff --git a/modules/desktop/polybar/module/battery.nix b/modules/desktop/polybar/module/battery.nix
index dc9e6f4..d392e16 100644
--- a/modules/desktop/polybar/module/battery.nix
+++ b/modules/desktop/polybar/module/battery.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Battery - Battery status module with icons and charging animation
 with config.scheme.withHashtag;
 {
   type = "internal/battery";
diff --git a/modules/desktop/polybar/module/cpu.nix b/modules/desktop/polybar/module/cpu.nix
index 64d5b47..9d5b859 100644
--- a/modules/desktop/polybar/module/cpu.nix
+++ b/modules/desktop/polybar/module/cpu.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# CPU - CPU usage percentage module
 with config.scheme.withHashtag;
 {
   type = "internal/cpu";
diff --git a/modules/desktop/polybar/module/date.nix b/modules/desktop/polybar/module/date.nix
index 0e432e9..7a9e1ca 100644
--- a/modules/desktop/polybar/module/date.nix
+++ b/modules/desktop/polybar/module/date.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Date - Current date display module
 with config.scheme.withHashtag;
 {
   type = "internal/date";
diff --git a/modules/desktop/polybar/module/default.nix b/modules/desktop/polybar/module/default.nix
index 2295ac6..1ccbd02 100644
--- a/modules/desktop/polybar/module/default.nix
+++ b/modules/desktop/polybar/module/default.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Module - Polybar module definitions (battery, cpu, date, i3, memory, volume, wifi, etc.)
 {
   "module/battery" = import ./battery.nix { inherit config; };
   "module/cpu" = import ./cpu.nix { inherit config; };
diff --git a/modules/desktop/polybar/module/ethernet-separator.nix b/modules/desktop/polybar/module/ethernet-separator.nix
index 2c2a738..cfdf9e4 100644
--- a/modules/desktop/polybar/module/ethernet-separator.nix
+++ b/modules/desktop/polybar/module/ethernet-separator.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Ethernet-separator - Visual separator for ethernet module
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/ethernet.nix b/modules/desktop/polybar/module/ethernet.nix
index 28c7a1b..72f8e0c 100644
--- a/modules/desktop/polybar/module/ethernet.nix
+++ b/modules/desktop/polybar/module/ethernet.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Ethernet - Wired network module (connection speed)
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/i3.nix b/modules/desktop/polybar/module/i3.nix
index 8565d41..f910b80 100644
--- a/modules/desktop/polybar/module/i3.nix
+++ b/modules/desktop/polybar/module/i3.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# i3 - i3 workspace display module (focused, occupied, urgent workspaces)
 with config.scheme.withHashtag;
 {
   type = "internal/i3";
diff --git a/modules/desktop/polybar/module/memory.nix b/modules/desktop/polybar/module/memory.nix
index 7f8de0a..d032377 100644
--- a/modules/desktop/polybar/module/memory.nix
+++ b/modules/desktop/polybar/module/memory.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Memory - RAM usage module (displays GB used)
 with config.scheme.withHashtag;
 {
   type = "internal/memory";
diff --git a/modules/desktop/polybar/module/separator.nix b/modules/desktop/polybar/module/separator.nix
index 0a75a30..23b52b9 100644
--- a/modules/desktop/polybar/module/separator.nix
+++ b/modules/desktop/polybar/module/separator.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Separator - Visual separator between modules
 with config.scheme.withHashtag;
 {
   type = "custom/text";
diff --git a/modules/desktop/polybar/module/time.nix b/modules/desktop/polybar/module/time.nix
index 6fe921d..e8dae08 100644
--- a/modules/desktop/polybar/module/time.nix
+++ b/modules/desktop/polybar/module/time.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Time - Current time display module (12-hour format)
 with config.scheme.withHashtag;
 {
   type = "internal/date";
diff --git a/modules/desktop/polybar/module/volume.nix b/modules/desktop/polybar/module/volume.nix
index eacd53d..1d1352a 100644
--- a/modules/desktop/polybar/module/volume.nix
+++ b/modules/desktop/polybar/module/volume.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# Volume - PulseAudio volume level module with icons
 with config.scheme.withHashtag;
 {
   type = "internal/pulseaudio";
diff --git a/modules/desktop/polybar/module/wifi-separator.nix b/modules/desktop/polybar/module/wifi-separator.nix
index 2527b68..6bb42cb 100644
--- a/modules/desktop/polybar/module/wifi-separator.nix
+++ b/modules/desktop/polybar/module/wifi-separator.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# WiFi-separator - Visual separator for WiFi module
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/wifi.nix b/modules/desktop/polybar/module/wifi.nix
index 5a4d17f..6ee848f 100644
--- a/modules/desktop/polybar/module/wifi.nix
+++ b/modules/desktop/polybar/module/wifi.nix
@@ -1,5 +1,6 @@
 { config }:
 
+# WiFi - Wireless network module (signal strength, speed)
 with config.scheme.withHashtag;
 {
   type = "internal/network";
diff --git a/modules/desktop/polybar/module/xwindow.nix b/modules/desktop/polybar/module/xwindow.nix
index fd73a6b..79c0f95 100644
--- a/modules/desktop/polybar/module/xwindow.nix
+++ b/modules/desktop/polybar/module/xwindow.nix
@@ -1,5 +1,6 @@
 { }:
 
+# XWindow - Focused window title module
 {
   type = "internal/xwindow";
   label = "%title:0:20:...%";