lint

Author: sandydoo

flake-module.nix

@@ -37,7 +37,7 @@ in
                 Nixpkgs to use in the pre-commit [`settings`](#opt-perSystem.pre-commit.settings).
               '';
               default = pkgs;
-              defaultText = lib.literalMD "`pkgs` (module argument)";
+              defaultText = lib.literalExpression "`pkgs` (module argument)";
             };
             settings = mkOption {
               type = types.submoduleWith {
@@ -51,21 +51,21 @@ in
             };
             shellHook = mkOption {
               type = types.str;
-              description = "A shell hook that sets up the git hooks in a development shell.";
+              description = "A shell hook that installs up the git hooks in a development shell.";
               default = cfg.settings.installationScript;
               defaultText = lib.literalExpression "bash statements";
               readOnly = true;
             };
             installationScript = mkOption {
               type = types.str;
-              description = "A bash fragment that sets up [pre-commit](https://pre-commit.com/).";
+              description = "A bash snippet that sets up the git hooks in the current repository.";
               default = cfg.settings.installationScript;
-              defaultText = lib.literalMD "bash statements";
+              defaultText = lib.literalExpression "bash statements";
               readOnly = true;
             };
             devShell = mkOption {
               type = types.package;
-              description = "A development shell with pre-commit installed and setup.";
+              description = "A development shell with the git hooks installed and all the packages made available.";
               readOnly = true;
             };
           };

modules/hook.nix

@@ -57,7 +57,7 @@ in
     name = mkOption {
       type = types.str;
       default = name;
-      defaultText = lib.literalMD "the attribute name the hook submodule is bound to, same as `id`";
+      defaultText = lib.literalExpression "the attribute name the hook submodule is bound to, same as `id`";
       description =
         ''
           The name of the hook. Shown during hook execution.