docs: Overhaul all the documentation

sw/default.nix

@@ -1,5 +1,12 @@
 { config, lib, pkgs, inputs, ... }:
 
+# ============================================================================
+# Software Module Entry Point
+# ============================================================================
+# This module manages the software configuration for the system. It provides
+# options to select the system type ('desktop' or 'kiosk') and handles
+# the conditional importation of the appropriate sub-modules.
+
 with lib;
 
 let
@@ -46,6 +53,7 @@ in
         git
         oh-my-posh
         inputs.lazyvim-nixvim.packages.${stdenv.hostPlatform.system}.nvim
+        # Custom update script
         (writeShellScriptBin "update-system" ''
           HOSTNAME=$(hostname)
           FLAKE_URI="github:UGA-Innovation-Factory/nixos-systems"
@@ -63,6 +71,7 @@ in
         '')
       ];
     }
+    # Import Desktop or Kiosk modules based on type
     (mkIf (cfg.type == "desktop") (import ./desktop { inherit config lib pkgs inputs; }))
     (mkIf (cfg.type == "kiosk") (import ./kiosk { inherit config lib pkgs inputs; }))
   ]);

sw/nvim.nix

@@ -1,5 +1,11 @@
 { pkgs, ... }:
 {
+  # ============================================================================
+  # Neovim Configuration
+  # ============================================================================
+  # This module configures Neovim, specifically setting up TreeSitter parsers
+  # to ensure syntax highlighting works correctly.
+  
   # https://github.com/nvim-treesitter/nvim-treesitter#i-get-query-error-invalid-node-type-at-position
   xdg.configFile."nvim/parser".source =
     let

sw/python.nix

@@ -1,5 +1,12 @@
 { config, lib, pkgs, ... }:
 
+# ============================================================================
+# Python Environment
+# ============================================================================
+# This module provides Python development tools. It installs 'pixi' and 'uv'
+# for project-based dependency management, rather than installing global
+# Python packages which can lead to conflicts.
+
 with lib;
 
 let

sw/theme.nix

@@ -1,5 +1,11 @@
 { pkgs, config, osConfig, lib, ... }:
 
+# ============================================================================
+# Shell Theme Configuration
+# ============================================================================
+# This module configures the shell environment (Zsh, Oh My Posh) for users.
+# It is imported by default for all users to ensure a consistent experience.
+
 let
   # Fetch upstream OMP theme once
   jyumppTheme = pkgs.fetchurl {
@@ -15,11 +21,9 @@ let
 
   isRoot = config.home.username == "root";
   themeFile = if isRoot then jyumppRootTheme else jyumppTheme;
-  
-  isZsh = osConfig.modules.users.shell == pkgs.zsh;
 in
 {
-  config = lib.mkIf isZsh {
+  config = {
     programs.zsh = {
       enable = true;