docs: Overhaul all the documentation

flake.nix

@@ -1,21 +1,41 @@
 {
+  # ============================================================================
+  # Flake Entry Point
+  # ============================================================================
+  # This file defines the inputs (dependencies) and outputs (configurations)
+  # for the NixOS systems. It ties together the hardware, software, and user
+  # configurations into deployable systems.
+
   inputs = {
+    # Core NixOS package repository (Release 25.11)
     nixpkgs.url = "github:NixOS/nixpkgs/nixos-25.11";
+    
+    # Older kernel packages for Surface compatibility if needed
     nixpkgs-old-kernel.url = "github:NixOS/nixpkgs/nixos-25.05";
+    
+    # Home Manager for user environment management
     home-manager = {
       url = "github:nix-community/home-manager/release-25.11";
       inputs.nixpkgs.follows = "nixpkgs";
     };
+    
+    # Disko for declarative disk partitioning
     disko = {
       url = "github:nix-community/disko";
       inputs.nixpkgs.follows = "nixpkgs";
     };
+    
+    # Hardware quirks and configurations
     nixos-hardware.url = "github:NixOS/nixos-hardware/master";
+    
+    # Neovim configuration
     lazyvim-nixvim.url = "github:azuwis/lazyvim-nixvim";
   };
   outputs = inputs@{ self, nixpkgs, nixpkgs-old-kernel, home-manager, disko, lazyvim-nixvim, nixos-hardware,... }: {
+    # Formatter for 'nix fmt'
     formatter.x86_64-linux = nixpkgs.legacyPackages.x86_64-linux.nixfmt-rfc-style;
 
+    # Generate NixOS configurations from hosts/default.nix
     nixosConfigurations = import ./hosts { inherit inputs; };
   };
 }