From 96dfa2bbd2b562f34bc206b878eb40248b163cc7 Mon Sep 17 00:00:00 2001
From: doc-claw-bot <qian.cai@outlook.com>
Date: Tue, 8 Sep 2026 07:32:59 +0000
Subject: [PATCH 1/2] docs: fix TuneD custom profile path in precheck guide

---
 check-before-deployment.md | 8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/check-before-deployment.md b/check-before-deployment.md
index 5962aba0dded2..b04f5ef627228 100644
--- a/check-before-deployment.md
+++ b/check-before-deployment.md
@@ -522,10 +522,14 @@ The steps to check and configure these parameters are as follows:
         2. Create a new tuned profile:
 
             ```bash
-            mkdir /etc/tuned/balanced-tidb-optimal/
-            vi /etc/tuned/balanced-tidb-optimal/tuned.conf
+            mkdir -p /etc/tuned/profiles/balanced-tidb-optimal/
+            vi /etc/tuned/profiles/balanced-tidb-optimal/tuned.conf
             ```
 
+            > **Note:**
+            >
+            > TuneD v2.23.0 and later stores user-defined profiles under `/etc/tuned/profiles/<profile_name>/`. If you place the profile directly under `/etc/tuned/<profile_name>/`, TuneD cannot detect it.
+
             ```
             [main]
             include=balanced

From 6836d0ba86b012e0ac50752a9b7505839477a7be Mon Sep 17 00:00:00 2001
From: doc-claw-bot <qian.cai@outlook.com>
Date: Tue, 8 Sep 2026 08:37:12 +0000
Subject: [PATCH 2/2] docs: clarify TuneD profile path by version

---
 check-before-deployment.md | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/check-before-deployment.md b/check-before-deployment.md
index b04f5ef627228..6ddb714e601e3 100644
--- a/check-before-deployment.md
+++ b/check-before-deployment.md
@@ -522,13 +522,18 @@ The steps to check and configure these parameters are as follows:
         2. Create a new tuned profile:
 
             ```bash
+            # For TuneD earlier than v2.23.0
+            mkdir -p /etc/tuned/balanced-tidb-optimal/
+            vi /etc/tuned/balanced-tidb-optimal/tuned.conf
+
+            # For TuneD v2.23.0 and later
             mkdir -p /etc/tuned/profiles/balanced-tidb-optimal/
             vi /etc/tuned/profiles/balanced-tidb-optimal/tuned.conf
             ```
 
             > **Note:**
             >
-            > TuneD v2.23.0 and later stores user-defined profiles under `/etc/tuned/profiles/<profile_name>/`. If you place the profile directly under `/etc/tuned/<profile_name>/`, TuneD cannot detect it.
+            > TuneD earlier than v2.23.0 uses `/etc/tuned/<profile_name>/tuned.conf`. TuneD v2.23.0 and later uses `/etc/tuned/profiles/<profile_name>/tuned.conf`. These path formats are version-specific and are not recognized by the other version range.
 
             ```
             [main]