clarify documentation and add missing garbage collection

configuration.nix

@@ -1,4 +1,7 @@
-# symlinkg this file to your /etc/nixos/ and make sure the directory is correct !
+# this file will import the saturnOS system as well as the hardware-configuration.nix
+# the existing hardware-configuration.nix is kept so that it can be rebuilt later 
+# rebuilding is useful if new hardware is added to the system, or if a driver is added
+
 {...}:
 {
 	imports = [ ./hardware-configuration.nix ./saturnOS ];

default.nix

@@ -1,16 +1,30 @@
-# welcome to saturnOS config, run nixos-help if you need it .
+# this is the main config which adds saturnOS components to the system
+# everything in this file *should* be portable accross all devices
+# portability failures in this file are a bug and should be reported 
+# this file will be used as is by the config script
+# the script will pull updates from this file occasionally
+
 { config, pkgs, lib, ...  }:
 {
 	imports = [
-		./modules
-		./system
+		./modules	# modules are used to add functionality currently not in base nixos, such as pretty hostnames
+				# these features may be upstreamed at some point
+
+		./system	# system is for configuration relevant specifically 
+				# to the system it's running on and not in base saturn
 	];
 
 	# nix options
 	nix.settings = {
-		experimental-features = "nix-command flakes";
-		auto-optimise-store = true;
+		experimental-features = "nix-command flakes"; # enables "nix ___" support
+		auto-optimise-store = true; # will attempt to reduce size from soft-links
 	};
+	nix.gc = {
+		automatic = true; # enables garbage collection
+		dates = "weekly"; # runs weekly
+		options = "--delete-older-than 30d"; # all packages / downloaded derivations older than 30d are deleted
+	};
+
 
 	# enable gnome
 	services.xserver.enable = true;
@@ -32,8 +46,7 @@
 		jack.enable = true;
 	};
 
-	# install packages
-	# `nix search` to add more
+	# install packages to the base saturn system
 	nixpkgs.config.allowUnfree = true;
 	environment.systemPackages = with pkgs; [
 	];
@@ -49,8 +62,8 @@
 	};
 	programs.fish.enable = true;
 
-	# enable configure services
-	services.printing.enable = true;	# printing
+	# enable / configure services
+	services.printing.enable = true; # printing
 	services.openssh.enable = true;	# remote shell
-	services.flatpak.enable = true;	#flatpak lol
+	services.flatpak.enable = true;	# enables flatpak
 }

system/custom.nix

@@ -1,2 +1,4 @@
-# this is for options not managed bysaturnConfig, added by the user
-# again this is an example template not meant to be used
+# this is for options not managed by the saturnConfig script, which are added by the user
+# this is an example template not meant to be used, it's a target to build build the script around
+{ ... }:
+{ }

system/default.nix

@@ -1,5 +1,5 @@
-#this is a template, but would be auto-generated by saturnConfig, when the system is first created and on later modification to the system options
-# it is not reccomended to use this file, as it should be generated by the script only
+# this is an example of what would be auto-generated by the saturnConfig script, when the system is first created and on later modification to the system options
+# it is not reccomended to use this file, as it is only a target to design the script around
 { config, pkgs, lib, ...  }:
 {
 	# importing custom user config