docs: Update inline code docs for LSP help

sw/builders/default.nix

@@ -17,9 +17,11 @@ let
   cfg = config.athenix.sw.builders;
 in
 {
-  options.athenix.sw.builders = {
+  options.athenix.sw.builders = mkOption {
+    type = lib.types.submodule {
+      options = {
         enable = mkOption {
-      type = types.bool;
+          type = lib.types.bool;
           default = false;
           description = ''
             Enable build server configuration.
@@ -34,9 +36,11 @@ in
           example = true;
         };
 
-    giteaRunner = {
+        giteaRunner = mkOption {
+          type = lib.types.submodule {
+            options = {
               enable = mkOption {
-        type = types.bool;
+                type = lib.types.bool;
                 default = false;
                 description = ''
                   Enable Gitea Actions self-hosted runner.
@@ -48,7 +52,7 @@ in
               };
 
               url = mkOption {
-        type = types.str;
+                type = lib.types.str;
                 description = ''
                   URL of the Gitea instance to connect to.
                   This should be the base URL without any path components.
@@ -57,7 +61,7 @@ in
               };
 
               tokenFile = mkOption {
-        type = types.path;
+                type = lib.types.path;
                 default = "/var/lib/gitea-runner-token";
                 description = ''
                   Path to file containing Gitea runner registration token.
@@ -75,7 +79,7 @@ in
               };
 
               extraLabels = mkOption {
-        type = types.listOf types.str;
+                type = lib.types.listOf lib.types.str;
                 default = [ ];
                 description = ''
                   Additional labels to identify this runner in workflow files.
@@ -89,7 +93,7 @@ in
               };
 
               name = mkOption {
-        type = types.str;
+                type = lib.types.str;
                 default = "athenix";
                 description = ''
                   Unique name for this runner instance.
@@ -99,6 +103,14 @@ in
               };
             };
           };
+          default = { };
+          description = "Gitea Actions runner configuration.";
+        };
+      };
+    };
+    default = { };
+    description = "Build server configuration (CI/CD, Gitea Actions).";
+  };
 
   config = mkIf cfg.enable (mkMerge [
     (import ./programs.nix {

sw/default.nix

@@ -37,8 +37,11 @@ in
   ];
 
   options.athenix.sw = {
+    # Software submodule for the Athenix system suite. sw.enable enables
+    # base packages and common configuration. Each sw.<type>.enable enables
+    # additional packages and services for that system type.
     enable = mkOption {
-      type = types.bool;
+      type = lib.types.bool;
       default = false;
       description = ''
         Enable standard workstation configuration with base packages.
@@ -53,17 +56,18 @@ in
       '';
     };
 
+    type = mkOption {
       # DEPRECATED: Backwards compatibility for external modules
       # Use athenix.sw.<type>.enable instead
-    type = mkOption {
+      type = lib.types.nullOr (lib.types.either lib.types.str (lib.types.listOf lib.types.str));
-      type = types.nullOr (types.either types.str (types.listOf types.str));
       default = null;
       description = "DEPRECATED: Use athenix.sw.<type>.enable instead. Legacy type selection.";
       visible = false;
     };
 
     extraPackages = mkOption {
-      type = types.listOf types.package;
+      # Additional packages to install beyond the defaults
+      type = lib.types.listOf lib.types.package;
       default = [ ];
       description = ''
         Additional system packages to install beyond the defaults.
@@ -73,7 +77,8 @@ in
     };
 
     excludePackages = mkOption {
-      type = types.listOf types.package;
+      # Packages to exclude from the default package list
+      type = lib.types.listOf lib.types.package;
       default = [ ];
       description = ''
         Packages to exclude from the default package list.

sw/desktop/default.nix

@@ -17,9 +17,11 @@ let
   cfg = config.athenix.sw.desktop;
 in
 {
-  options.athenix.sw.desktop = {
+  options.athenix.sw.desktop = mkOption {
+    type = lib.types.submodule {
+      options = {
         enable = mkOption {
-      type = types.bool;
+          type = lib.types.bool;
           default = false;
           description = ''
             Enable full desktop environment with KDE Plasma 6.
@@ -37,6 +39,10 @@ in
           example = true;
         };
       };
+    };
+    default = { };
+    description = "Desktop environment configuration (KDE Plasma 6).";
+  };
 
   config = mkIf cfg.enable (mkMerge [
     (import ./programs.nix {

sw/headless/default.nix

@@ -17,9 +17,11 @@ let
   cfg = config.athenix.sw.headless;
 in
 {
-  options.athenix.sw.headless = {
+  options.athenix.sw.headless = mkOption {
+    type = lib.types.submodule {
+      options = {
         enable = mkOption {
-      type = types.bool;
+          type = lib.types.bool;
           default = false;
           description = ''
             Enable minimal headless server configuration.
@@ -35,6 +37,10 @@ in
           example = true;
         };
       };
+    };
+    default = { };
+    description = "Headless server configuration (SSH, minimal CLI tools).";
+  };
 
   config = mkIf cfg.enable (mkMerge [
     (import ./programs.nix {

sw/stateless-kiosk/default.nix

@@ -14,9 +14,11 @@ let
   cfg = config.athenix.sw.stateless-kiosk;
 in
 {
-  options.athenix.sw.stateless-kiosk = {
+  options.athenix.sw.stateless-kiosk = mkOption {
+    type = lib.types.submodule {
+      options = {
         enable = mkOption {
-      type = types.bool;
+          type = lib.types.bool;
           default = false;
           description = ''
             Enable stateless kiosk mode for diskless PXE boot systems.
@@ -34,7 +36,7 @@ in
         };
 
         kioskUrl = mkOption {
-      type = types.str;
+          type = lib.types.str;
           default = "https://ha.factory.uga.edu";
           description = ''
             Default URL to display in the kiosk browser.
@@ -45,6 +47,10 @@ in
           example = "https://homeassistant.lan:8123/lovelace/dashboard";
         };
       };
+    };
+    default = { };
+    description = "Stateless kiosk configuration (PXE boot, Sway, MAC-based routing).";
+  };
 
   config = mkIf cfg.enable (mkMerge [
     (import ./kiosk-browser.nix {

sw/tablet-kiosk/default.nix

@@ -12,9 +12,11 @@ let
   cfg = config.athenix.sw.tablet-kiosk;
 in
 {
-  options.athenix.sw.tablet-kiosk = {
+  options.athenix.sw.tablet-kiosk = mkOption {
+    type = lib.types.submodule {
+      options = {
         enable = mkOption {
-      type = types.bool;
+          type = lib.types.bool;
           default = false;
           description = ''
             Enable tablet kiosk mode with touch-optimized interface.
@@ -33,7 +35,7 @@ in
         };
 
         kioskUrl = mkOption {
-      type = types.str;
+          type = lib.types.str;
           default = "https://ha.factory.uga.edu";
           description = ''
             URL to display in the kiosk browser on startup.
@@ -42,6 +44,10 @@ in
           example = "https://dashboard.example.com";
         };
       };
+    };
+    default = { };
+    description = "Tablet kiosk configuration (Phosh, touch interface).";
+  };
 
   config = mkIf cfg.enable (mkMerge [
     (import ./programs.nix {

sw/updater.nix

@@ -9,10 +9,10 @@ with lib;
 
 {
   options.athenix.sw.remoteBuild = lib.mkOption {
-    type = types.submodule {
+    type = lib.types.submodule {
       options = {
         hosts = mkOption {
-          type = types.listOf types.str;
+          type = lib.types.listOf lib.types.str;
           default = [ "engr-ugaif@192.168.11.133 x86_64-linux" ];
           description = ''
             List of remote build hosts for system rebuilding.
@@ -31,7 +31,7 @@ with lib;
         };
 
         enable = mkOption {
-          type = types.bool;
+          type = lib.types.bool;
           default = false;
           description = ''
             Whether to enable remote builds for the 'update-system' command.