From 938928e5666083ea22416b023feff2b44c91235d Mon Sep 17 00:00:00 2001
From: Kelly Mears <developers@tinypixel.dev>
Date: Fri, 19 Jan 2024 03:26:20 -0500
Subject: [PATCH] =?UTF-8?q?=F0=9F=93=95=20docs(none):=20mention=20@roots/b?=
 =?UTF-8?q?ud-preset-wordpress/stylelint=20(#2543)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Mention `@roots/bud-preset-wordpress/stylelint` export.

- Fixes: #2542
- See also: #2538

## Type of change

**NONE: internal change**
---
 .../extensions/bud-preset-wordpress/index.mdx |  4 ---
 .../bud-preset-wordpress/stylelint.mdx        | 26 +++++++++++++++++++
 2 files changed, 26 insertions(+), 4 deletions(-)
 create mode 100644 sources/@repo/docs/content/extensions/bud-preset-wordpress/stylelint.mdx

diff --git a/sources/@repo/docs/content/extensions/bud-preset-wordpress/index.mdx b/sources/@repo/docs/content/extensions/bud-preset-wordpress/index.mdx
index 58e0a82cfb..7a2a66aca9 100644
--- a/sources/@repo/docs/content/extensions/bud-preset-wordpress/index.mdx
+++ b/sources/@repo/docs/content/extensions/bud-preset-wordpress/index.mdx
@@ -4,9 +4,6 @@ description: 'Recommended extensions and base configuration for WordPress projec
 sidebar_label: '@roots/bud-preset-wordpress'
 ---
 
-import Tabs from '@theme/Tabs'
-import TabItem from '@theme/TabItem'
-
 The [@roots/bud-preset-wordpress](/extensions/bud-preset-wordpress) package is a great starting point for WordPress plugins & themes.
 
 If you plan on using it in a WordPress theme you should consider using [@roots/sage](https://github.com/roots/sage).
@@ -34,7 +31,6 @@ The [@roots/bud-preset-wordpress preset](/extensions/bud-preset-wordpress) inclu
 - @roots/bud-wordpress-dependencies
 - @roots/bud-wordpress-externals
 - @roots/bud-wordpress-theme-json
-- @roots/wordpress-hmr
 
 ## Managing WordPress enqueues
 
diff --git a/sources/@repo/docs/content/extensions/bud-preset-wordpress/stylelint.mdx b/sources/@repo/docs/content/extensions/bud-preset-wordpress/stylelint.mdx
new file mode 100644
index 0000000000..7f89850f71
--- /dev/null
+++ b/sources/@repo/docs/content/extensions/bud-preset-wordpress/stylelint.mdx
@@ -0,0 +1,26 @@
+---
+title: Stylelint
+description: 'Setting up stylelint rules'
+sidebar_label: Stylelint
+---
+
+If you are using [stylelint](https://stylelint.io/) you may wish to extend our base configuration:
+
+```js
+module.exports = {
+  extends: [
+    '@roots/bud-wordpress-preset/stylelint'],
+};
+```
+
+This is especially true if you are using the [@roots/bud-sass/stylelint](/extensions/bud-sass) configuration, which conflicts with the WordPress standard naming scheme for css variables.
+
+```js
+module.exports = {
+  extends: [
+    '@roots/bud-stylelint/config',
+    '@roots/bud-sass/stylelint',
+    '@roots/bud-wordpress-preset/stylelint'
+  ]
+}
+```