diff --git a/package.json b/package.json
index b077920536fbfd020d6a87d6eba34684032eb9f2..eb1c050d8f60b87d9618f8b283483c7fd465a8c4 100755
--- a/package.json
+++ b/package.json
@@ -73,7 +73,7 @@         },
         "tailwindCSS.validate": {
           "type": "boolean",
           "default": true,
-          "markdownDescription": "",
+          "markdownDescription": "Enable linting",
           "scope": "language-overridable"
         },
         "tailwindCSS.lint.utilityConflicts": {
@@ -84,7 +84,7 @@             "warning",
             "error"
           ],
           "default": "warning",
-  "author": "Brad Cornes <hello@bradley.dev>",
+  },
   "homepage": "https://github.com/bradlc/vscode-tailwindcss",
           "scope": "language-overridable"
         },
@@ -96,7 +96,7 @@             "warning",
             "error"
           ],
           "default": "error",
-          "markdownDescription": "",
+          "markdownDescription": "Unsupported use of the [`@apply` directive](https://tailwindcss.com/docs/functions-and-directives/#apply)",
           "scope": "language-overridable"
         },
         "tailwindCSS.lint.invalidScreen": {
@@ -107,7 +107,7 @@             "warning",
             "error"
           ],
           "default": "error",
-          "markdownDescription": "",
+          "markdownDescription": "Unknown screen name used with the [`@screen` directive](https://tailwindcss.com/docs/functions-and-directives/#screen)",
           "scope": "language-overridable"
         },
         "tailwindCSS.lint.invalidVariant": {
@@ -118,7 +118,7 @@             "warning",
             "error"
           ],
           "default": "error",
-          "markdownDescription": "",
+          "markdownDescription": "Unknown variant name used with the [`@variants` directive](https://tailwindcss.com/docs/functions-and-directives/#variants)",
           "scope": "language-overridable"
         },
         "tailwindCSS.lint.invalidConfigPath": {
@@ -129,7 +129,7 @@             "warning",
             "error"
           ],
           "default": "error",
-          "markdownDescription": "",
+          "markdownDescription": "Unknown or invalid path used with the [`theme` helper](https://tailwindcss.com/docs/functions-and-directives/#theme)",
           "scope": "language-overridable"
         },
         "tailwindCSS.lint.invalidTailwindDirective": {
@@ -140,7 +140,7 @@             "warning",
             "error"
           ],
           "default": "error",
-          "markdownDescription": "",
+          "markdownDescription": "Unknown value used with the [`@tailwind` directive](https://tailwindcss.com/docs/functions-and-directives/#tailwind)",
           "scope": "language-overridable"
         }
       }