From 8c8b0c114c8ff02aa47a668824446abee3c8e169 Mon Sep 17 00:00:00 2001
From: qiancai <qqzczy@126.com>
Date: Wed, 16 Sep 2026 12:49:48 +0800
Subject: [PATCH 1/2] ci(filesystem): sync docs from release-8.5

Move the English Filesystem directory and TOC into its independent master staging tree during targeted and full updates.

Register only the English docs source; translated workflows can be added later.
---
 .github/workflows/update.yml | 40 ++++++++++++++++++++++++++++++++++++
 docs.json                    |  9 ++++++++
 2 files changed, 49 insertions(+)

diff --git a/.github/workflows/update.yml b/.github/workflows/update.yml
index b667af36b5..2ac8786c45 100644
--- a/.github/workflows/update.yml
+++ b/.github/workflows/update.yml
@@ -74,6 +74,25 @@ jobs:
             fi
           }
 
+          sync_tidb_cloud_filesystem() {
+            local source_root="$1"
+            local target_root="./markdown-pages/en/tidb-cloud-filesystem/master"
+
+            mkdir -p "${target_root}"
+            rm -rf "${target_root}/tidb-cloud-filesystem"
+            rm -f "${target_root}/TOC-tidb-cloud-filesystem.md"
+
+            if [ -d "${source_root}/tidb-cloud-filesystem" ]
+            then
+              mv "${source_root}/tidb-cloud-filesystem" "${target_root}/"
+            fi
+
+            if [ -f "${source_root}/TOC-tidb-cloud-filesystem.md" ]
+            then
+              mv "${source_root}/TOC-tidb-cloud-filesystem.md" "${target_root}/"
+            fi
+          }
+
           # handle zh auto translated docs branch(only cloud)
           if [ ${{ inputs.repo }} = "pingcap/docs" ] && [ ${{ inputs.branch }} = ${{ env.ZH_CLOUD_BRANCH }} ]
           then
@@ -99,6 +118,7 @@ jobs:
           yarn download:tidb-cloud:en --ref ${{ inputs.branch }}
           yarn download ${{ inputs.repo }} --ref ${{ inputs.branch }}
           sync_tidb_cloud_lake "en" "./markdown-pages/en/tidb/${{ inputs.branch }}"
+          sync_tidb_cloud_filesystem "./markdown-pages/en/tidb/${{ inputs.branch }}"
           exit 0
           fi
 
@@ -137,9 +157,29 @@ jobs:
             fi
           }
 
+          sync_tidb_cloud_filesystem() {
+            local source_root="$1"
+            local target_root="./markdown-pages/en/tidb-cloud-filesystem/master"
+
+            mkdir -p "${target_root}"
+            rm -rf "${target_root}/tidb-cloud-filesystem"
+            rm -f "${target_root}/TOC-tidb-cloud-filesystem.md"
+
+            if [ -d "${source_root}/tidb-cloud-filesystem" ]
+            then
+              mv "${source_root}/tidb-cloud-filesystem" "${target_root}/"
+            fi
+
+            if [ -f "${source_root}/TOC-tidb-cloud-filesystem.md" ]
+            then
+              mv "${source_root}/TOC-tidb-cloud-filesystem.md" "${target_root}/"
+            fi
+          }
+
           sudo rm -fr ./markdown-pages/*
           yarn download:tidb:en:all
           sync_tidb_cloud_lake "en" "./markdown-pages/en/tidb/${{ env.EN_CLOUD_BRANCH }}"
+          sync_tidb_cloud_filesystem "./markdown-pages/en/tidb/${{ env.EN_CLOUD_BRANCH }}"
           yarn download:tidb-cloud:en
           yarn download:tidb:zh:all
           sync_tidb_cloud_lake "zh" "./markdown-pages/zh/tidb/release-8.5"
diff --git a/docs.json b/docs.json
index d72261c274..187fc6999d 100644
--- a/docs.json
+++ b/docs.json
@@ -227,6 +227,15 @@
           "versions": ["master"]
         }
       }
+    },
+    "tidb-cloud-filesystem": {
+      "target": "release-8.5",
+      "languages": {
+        "en": {
+          "repo": "pingcap/docs",
+          "versions": ["master"]
+        }
+      }
     }
   },
   "redirect": {

From 5c7c7b967b5f8155df3bfa3824ad313291d020d9 Mon Sep 17 00:00:00 2001
From: qiancai <qqzczy@126.com>
Date: Wed, 16 Sep 2026 15:54:05 +0800
Subject: [PATCH 2/2] chore(filesystem): register future zh and ja docs

---
 docs.json | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs.json b/docs.json
index 187fc6999d..feb1cdf9f0 100644
--- a/docs.json
+++ b/docs.json
@@ -234,6 +234,14 @@
         "en": {
           "repo": "pingcap/docs",
           "versions": ["master"]
+        },
+        "zh": {
+          "repo": "pingcap/docs",
+          "versions": ["master"]
+        },
+        "ja": {
+          "repo": "pingcap/docs",
+          "versions": ["master"]
         }
       }
     }