wrapper/rc: document vim.globals better

modules/default.nix

@@ -81,6 +81,8 @@ inputs: {
     optional = false;
   }) (buildConfigPlugins vimOptions.optPlugins);
 
+  # combine built start and optional plugins
+  # into a single list
   plugins = builtStartPlugins ++ builtOptPlugins;
 
   # additional Lua and Python3 packages, mapped to their respective functions

modules/wrapper/rc/options.nix

@@ -70,9 +70,19 @@ in {
     };
 
     globals = mkOption {
-      default = {};
       type = attrs;
-      description = "Set containing global variable values";
+      default = {};
+      description = ''
+        An attribute set containing global variable values
+        for storing vim variables as early as possible. If
+        populated, this soption will set vim variables in the
+        built configRC as the first item.
+
+        E.g. {foo = "bar"} will set `g:foo` to "bar" where
+        the type of `bar` in the resulting vimscript will be
+        infered from the type of the value in the `{name = value}`
+        pair.
+      '';
     };
 
     configRC = mkOption {