diff --git a/README.md b/README.md
index 27cc6e8c480bc703fa2c9a987bd60aac0b73250a..839b718dc14b5039abe8416027f3c0a3ec73057e 100644
--- a/README.md
+++ b/README.md
@@ -1,60 +1,26 @@
 # Tailwind CSS IntelliSense
 
-> [Tailwind CSS](https://tailwindcss.com/) class name completion for VS Code
+## Installation
 
-**[Get it from the VS Code Marketplace →](https://marketplace.visualstudio.com/items?itemName=bradlc.vscode-tailwindcss)**
-
-<img src="https://raw.githubusercontent.com/bradlc/vscode-tailwindcss/master/img/html.gif" alt="HTML autocompletion" width="750">
-
-## Requirements
-
-This extension requires:
-- a `tailwind.config.js` file to be [present in your project folder](https://github.com/bradlc/vscode-tailwindcss/blob/master/package.json#L38). You can create it with `npx tailwind init`.
-- `tailwindcss` to be installed (present in project `node_modules/`)
+In order for the extension to activate you must have [`tailwindcss` installed](https://tailwindcss.com/docs/installation/#1-install-tailwind-via-npm) and a [Tailwind config file](https://tailwindcss.com/docs/installation/#3-create-your-tailwind-config-file-optional) named `tailwind.config.js` or `tailwind.js` in your workspace.
 
 ## Features
 
-Tailwind CSS IntelliSense uses your projects Tailwind installation and configuration to provide suggestions as you type.
-
-It also includes features that improve the overall Tailwind experience, including improved syntax highlighting, and CSS previews.
-
-### HTML (including Vue, JSX, PHP etc.)
-
-- [Class name suggestions, including support for Emmet syntax](#class-name-suggestions-including-support-for-emmet-syntax)
-  - Suggestions include color previews where applicable, for example for text and background colors
-  - They also include a preview of the actual CSS for that class name
-- [CSS preview when hovering over class names](#css-preview-when-hovering-over-class-names)
-
-### CSS
-
-- [Suggestions when using `@apply` and config helpers](#suggestions-when-using-apply-and-config)
-- Suggestions when using the `@screen` directive
-- Suggestions when using the `@variants` directive
-- [Improves syntax highlighting when using `@apply` and config helpers](#improves-syntax-highlighting-when-using-apply-and-config-helpers)
-
-## Examples
-
-#### Class name suggestions, including support for Emmet syntax
-
-<img src="https://raw.githubusercontent.com/bradlc/vscode-tailwindcss/master/img/html.gif" alt="HTML autocompletion" width="750">
+- **Autocomplete**
+  Intelligent suggestions for class names, [CSS directives](https://tailwindcss.com/docs/functions-and-directives/), and the [`theme` helper](https://tailwindcss.com/docs/functions-and-directives/#theme)
 
-#### CSS preview when hovering over class names
+- **Hover Preview**
+  See the complete CSS for a Tailwind class name by hovering over it
 
-<img src="https://raw.githubusercontent.com/bradlc/vscode-tailwindcss/master/img/html-hover.gif" alt="HTML hover preview" width="750">
-
-#### Suggestions when using `@apply` and config helpers
-
-<img src="https://raw.githubusercontent.com/bradlc/vscode-tailwindcss/master/img/css.gif" alt="CSS autocompletion" width="750">
-
-#### Improves syntax highlighting when using `@apply` and config helpers
-
-Before:
+- **Linting**
+  Highlights errors and potential bugs in your HTML and CSS files
 
-<img src="https://raw.githubusercontent.com/bradlc/vscode-tailwindcss/master/img/css-highlighting-before.png" alt="CSS syntax highlighting before" width="400">
+- **CSS Syntax Highlighting**
+  Provides syntax definitions so that use of Tailwind features doesn’t mess up your syntax highlighting
 
-After:
+## Screenshots/Examples?
 
-<img src="https://raw.githubusercontent.com/bradlc/vscode-tailwindcss/master/img/css-highlighting-after.png" alt="CSS syntax highlighting after" width="400">
+## Troubleshooting
 
 ## Settings
 
@@ -70,7 +36,7 @@   }
 }
 ```
 
-### `tailwindcss.emmetCompletions`
+### `tailwindCSS.emmetCompletions`
 
 Enable completions when using [Emmet](https://emmet.io/)-style syntax, for example `div.bg-red-500.uppercase`. **Default: `false`**
 
@@ -79,3 +45,11 @@ {
   "tailwindCSS.emmetCompletions": true
 }
 ```
+
+### `tailwindCSS.validate`
+
+Enable linting. Rules can be configured individually using the `tailwindcss.lint` settings:
+
+- `ignore`: disable lint rule entirely
+- `warning`: rule violations will be considered "warnings," typically represented by a yellow underline
+- `error`: rule violations will be considered "errors," typically represented by a red underline