17 files changed, 17 insertions, 0 deletions
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:...%";