From d03f41565972734b51548758eb0b4170d187d8b7 Mon Sep 17 00:00:00 2001
From: Swanand01 <swanandmathekar@gmail.com>
Date: Fri, 29 May 2026 22:08:29 +0530
Subject: [PATCH] chore: docs

---
 docs/lint-configs.md | 103 +++++++++++++++++++++++++++++++++++++++++++
 docs/tailwind.md     |   6 +--
 2 files changed, 106 insertions(+), 3 deletions(-)
 create mode 100644 docs/lint-configs.md

diff --git a/docs/lint-configs.md b/docs/lint-configs.md
new file mode 100644
index 00000000..5b7f15d3
--- /dev/null
+++ b/docs/lint-configs.md
@@ -0,0 +1,103 @@
+# Lint Configs
+
+The theme uses two shareable configs from [`wp-tooling`](https://github.com/rtCamp/wp-tooling) to standardise linting across rtCamp projects:
+
+| Package | Purpose |
+|---|---|
+| `@rtcamp/eslint-config` | ESLint flat config for WordPress JS |
+| `@rtcamp/stylelint-config` | Stylelint config for WordPress SCSS/CSS |
+
+---
+
+## ESLint — `@rtcamp/eslint-config`
+
+### What it includes
+
+- `@wordpress/eslint-plugin` recommended rules
+- `@eslint-community/eslint-plugin-eslint-comments` recommended rules
+- `eslint-plugin-jest` flat/recommended rules, scoped to `**/*.test.js`
+
+Requires ESLint v9+ (flat config only — no legacy `.eslintrc` support).
+
+### Install
+
+```bash
+npm install --save-dev @rtcamp/eslint-config eslint @wordpress/eslint-plugin
+```
+
+`eslint` and `@wordpress/eslint-plugin` must be listed explicitly — `@wordpress/scripts` pulls in `eslint@9` transitively, which conflicts with `@rtcamp/eslint-config`'s `eslint@^10` peer dependency.
+
+### Usage in this theme
+
+Spread the shared config in `eslint.config.mjs` and add theme-specific overrides on top:
+
+```js
+import rtcampEslint from '@rtcamp/eslint-config';
+
+export default [
+    ...rtcampEslint,
+
+    // Theme-specific overrides
+    {
+        languageOptions: { sourceType: 'module' },
+        rules: {
+            'jsdoc/check-indentation': 'error',
+            '@wordpress/dependency-group': 'error',
+        },
+    },
+];
+```
+
+---
+
+## Stylelint — `@rtcamp/stylelint-config`
+
+### What it includes
+
+- `@wordpress/stylelint-config` — WordPress CSS rules
+- `@wordpress/stylelint-config/scss` — SCSS-specific rules
+
+### Install
+
+```bash
+npm install --save-dev @rtcamp/stylelint-config
+```
+
+### Usage in this theme
+
+In `.stylelintrc.json`:
+
+```json
+{
+    "extends": "@rtcamp/stylelint-config",
+    "ignoreFiles": [
+        "**/*.js"
+    ],
+    "rules": {}
+}
+```
+
+`@rtcamp/stylelint-config` already extends both the base WordPress config and its SCSS variant, so the explicit `/scss` reference is no longer needed.
+
+The existing `.stylelintignore` file continues to work unchanged.
+
+---
+
+## Running the linters
+
+```bash
+# Check JS
+npm run lint:js
+
+# Fix JS
+npm run lint:js:fix
+
+# Check CSS/SCSS
+npm run lint:css
+
+# Fix CSS/SCSS
+npm run lint:css:fix
+
+# Run all linters in parallel
+npm run lint:all
+```
diff --git a/docs/tailwind.md b/docs/tailwind.md
index 4a07618e..43a0e8cd 100644
--- a/docs/tailwind.md
+++ b/docs/tailwind.md
@@ -6,21 +6,21 @@ Tailwind v4 support is opt-in. When enabled, `GenerateTailwindThemePlugin` reads
 
 **1. Install the plugin package**
 ```bash
-npm install --save-dev @rtcamp/wp-tooling tailwindcss @tailwindcss/postcss
+npm install --save-dev @rtcamp/tailwind-config
 ```
 
 **2. Configure PostCSS**
 
 Create or update `postcss.config.js` in the theme root:
 ```js
-module.exports = require( '@rtcamp/wp-tooling/tailwind-config/postcss' );
+module.exports = require( '@rtcamp/tailwind-config/postcss' );
 ```
 
 **3. Add the plugin to `webpack.config.js`**
 
 In the `styles` compiler config, add `GenerateTailwindThemePlugin` to the plugins array:
 ```js
-const { GenerateTailwindThemePlugin } = require( '@rtcamp/wp-tooling/tailwind-config' );
+const { GenerateTailwindThemePlugin } = require( '@rtcamp/tailwind-config' );
 
 // inside the styles config:
 plugins: [