modules/flake: refactor modules

2 files changed, 19 insertions, 3 deletions

diff --git a/modules/flake/homeConfigurations.nix b/modules/flake/homeConfigurations.nix
index b4d966f..1c54b0c 100644
--- a/modules/flake/homeConfigurations.nix
+++ b/modules/flake/homeConfigurations.nix
@@ -3,7 +3,7 @@
   flake-parts-lib,
   ...
 }: let
-  inherit (lib) mkOption types;
+  inherit (lib) mkOption types literalExpression;
   inherit (flake-parts-lib) mkTransposedPerSystemModule;
 in
   mkTransposedPerSystemModule {
@@ -12,8 +12,19 @@ in
       type = types.lazyAttrsOf types.raw;
       default = {};
       description = ''
-        An attribute set containing home-manager homeConfigurations
+        Instantiated home-manager configurations. Used by `home-manager`
+      '';
+      example = literalExpression ''
+        {
+        	user = inputs.home-manager.homeManagerConfiguration {
+        		pkgs = import inputs.nixpkgs {inherit system;};
+        		modules = [
+        			./my-users/home.nix
+        		];
+        	};
+        }
       '';
     };
+
     file = ./homeConfigurations.nix;
   }
diff --git a/modules/flake/hydraJobs.nix b/modules/flake/hydraJobs.nix
index 57aa3af..cfe9ca7 100644
--- a/modules/flake/hydraJobs.nix
+++ b/modules/flake/hydraJobs.nix
@@ -12,7 +12,12 @@ in {
         type = types.lazyAttrsOf types.raw;
         default = {};
         description = ''
-          An attribute set containing home-manager homeConfigurations
+          A collection of jobsets for Hydra. See https://nixos.wiki/wiki/Hydra#Flake_jobset
+        '';
+        example = ''
+          {
+          	inherit (self) packages;
+          }
         '';
       };
     };