diff --git a/modules/plugins/notes/neorg/config.nix b/modules/plugins/notes/neorg/config.nix
index 54a6bd8c..fab5079d 100644
--- a/modules/plugins/notes/neorg/config.nix
+++ b/modules/plugins/notes/neorg/config.nix
@@ -34,6 +34,7 @@ in {
     }
 
     (mkIf cfg.treesitter.enable {
+      vim.treesitter.enable = true;
       vim.treesitter.grammars = [cfg.treesitter.norgPackage];
     })
   ]);
diff --git a/modules/plugins/notes/neorg/neorg.nix b/modules/plugins/notes/neorg/neorg.nix
index eae7a3c1..ed1b0435 100644
--- a/modules/plugins/notes/neorg/neorg.nix
+++ b/modules/plugins/notes/neorg/neorg.nix
@@ -17,14 +17,23 @@ in {
       load = {
         "core.defaults" = mkOption {
           default = {};
+          description = ''
+            all of the most important modules that any user would want to have a "just works" experience
+          '';
 
           type = submodule {
             options = {
-              enable = mkEnableOption "Wrapper to interface with several different completion engines.";
+              enable = mkEnableOption ''
+            all of the most important modules that any user would want to have a "just works" experience
+            '';
               config = {
                 disable = mkOption {
+                  description = ''
+                    list of modules from to be disabled from core.defaults
+                  '';
                   type = listOf str;
                   default = [];
+                  example = ["core.autocommands" "core.itero"];
                 };
               };
             };