From 74c155722d4489e0545101be8335eb6cc804a3ae Mon Sep 17 00:00:00 2001
From: wouter bolsterlee <wouter@bolsterl.ee>
Date: Tue, 17 Feb 2026 11:33:13 +0100
Subject: [PATCH 1/2] docs: drop trailing whitespace from readme

---
 README.md | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/README.md b/README.md
index b9d71fe..a9d6550 100644
--- a/README.md
+++ b/README.md
@@ -117,14 +117,14 @@ type Severity = 'error' | 'warning';
 interface SecondaryOptions {
   fix?: boolean;
   ignore?: PhysicalKeywordProperty[],
-  severity?: Severity 
+  severity?: Severity
 }
 ```
 
 ```json
 {
   "rules": {
-    "logical-css/require-logical-keywords": [true, { 
+    "logical-css/require-logical-keywords": [true, {
       "fix": true,
       "ignore": ["caption-side", "offset-anchor"],
       "severity": "error",
@@ -298,14 +298,14 @@ type Severity = 'error' | 'warning';
 interface SecondaryOptions {
   fix?: boolean;
   ignore?: PhysicalProperty[],
-  severity?: Severity 
+  severity?: Severity
 }
 ```
 
 ```json
 {
   "rules": {
-    "logical-css/require-logical-properties": [true, { 
+    "logical-css/require-logical-properties": [true, {
       "fix": true,
       "ignore": ["height", "scroll-margin-bottom", "width"],
       "severity": "error",
@@ -687,14 +687,14 @@ type Severity = 'error' | 'warning';
 interface SecondaryOptions {
   fix?: boolean;
   ignore?: PhysicalUnit[],
-  severity?: Severity 
+  severity?: Severity
 }
 ```
 
 ```json
 {
   "rules": {
-    "logical-css/require-logical-units": [true, { 
+    "logical-css/require-logical-units": [true, {
       "fix": true,
       "ignore": ["vh", "dvw"],
       "severity": "error",

From f5b0c63db8927060bb0c225692e2f05f8f0e2fea Mon Sep 17 00:00:00 2001
From: wouter bolsterlee <wouter@bolsterl.ee>
Date: Tue, 17 Feb 2026 11:47:45 +0100
Subject: [PATCH 2/2] =?UTF-8?q?docs:=20add=201.x=20=E2=86=92=202.x=20upgra?=
 =?UTF-8?q?de=20notes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index a9d6550..4c59f66 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@ A Stylelint plugin to enforce the use of [logical CSS properties, values and uni
 
 ## Table of Contents
 
-[Getting Started](#getting-started) | [Quickstart](#quickstart) | [Plugin Configs](#logical-css-configs) |  [Plugin Rules](#logical-css-rules) | [Troubleshooting](#troubleshooting)
+[Getting Started](#getting-started) | [Quickstart](#quickstart) | [Plugin Configs](#logical-css-configs) | [Plugin Rules](#logical-css-rules) | [Troubleshooting](#troubleshooting) | [Upgrading from 1.x → 2.x](#upgrading-from-1x--2x)
 
 ## Getting Started
 
@@ -846,3 +846,17 @@ div {
   width: 100%;
 }
 ```
+
+---
+
+## Upgrading from 1.x → 2.x
+
+To upgrade from 1.x [(documentation)](./V1-DOCUMENTATION.md) → 2.x, change your Stylelint configuration:
+
+- Include the recommended config in the `extends` array
+- To use the defaults, drop the `plugin/use-logical-*` entries from `rules`
+
+If you had specific config that you want to keep, note that the rules have been split and renamed:
+
+- `plugin/use-logical-properties-and-values` → `logical-css/require-logical-keywords` and `logical-css/require-logical-properties`
+- `plugin/use-logical-units` → `logical-css/require-logical-units`