modules: better document most things

1 files changed, 6 insertions, 1 deletions

diff --git a/modules/nixos/traits/nvidia.nix b/modules/nixos/traits/nvidia.nix
index 5fec7db..1b37086 100644
--- a/modules/nixos/traits/nvidia.nix
+++ b/modules/nixos/traits/nvidia.nix
@@ -17,12 +17,13 @@ in
   config = lib.mkIf cfg.enable (
     lib.mkMerge [
       {
+        # NOTE: this is experiemental
         boot.kernelParams = lib.optional usingNvidia "nvidia_drm.fbdev=1";
 
         services.xserver.videoDrivers = [ "nvidia" ];
 
         hardware = {
-          graphics.extraPackages = [ pkgs.vaapiVdpau ];
+          graphics.extraPackages = [ pkgs.vaapiVdpau ]; # TODO: does this work...?
           nvidia = {
             package = lib.mkDefault config.boot.kernelPackages.nvidiaPackages.latest;
             modesetting.enable = true;
@@ -34,10 +35,14 @@ in
         specialisation = {
           nvk.configuration = {
             boot = {
+              # required for GSP firmware
               kernelParams = [ "nouveau.config=NvGspRm=1" ];
+              # we want early KMS 
+              # https://wiki.archlinux.org/title/Kernel_mode_setting#Early_KMS_start
               initrd.kernelModules = [ "nouveau" ];
             };
 
+            # TODO: make sure we don't need this anymore
             environment.sessionVariables = {
               MESA_VK_VERSION_OVERRIDE = "1.3";
             };