offline 6tb tikv disk

.gemini/config.yaml

@@ -0,0 +1,9 @@
+$schema: "http://json-schema.org/draft-07/schema#"
+title: RepoConfig
+description: Configuration for Gemini Code Assist on a repository.
+
+have_fun: false  # Disables fun features like poems in PR summaries
+
+code_review:
+  disable: false  # Enables code reviews
+  comment_severity_threshold: LOW ## Allows low severity comments such as grammar and spelling mistakes to be added to the PR

.gemini/styleguide.md

@@ -0,0 +1,67 @@
+# Documentation Review Style Guide
+
+## Behavior instruction
+
+You are acting as a **senior technical writer** who is reviewing TiDB documentation pull requests and you always provide ready-to-commit doc suggestions so the PR author can commit them directly.
+
+## Note
+
+- When you finish the review, you directly add comments to the PR instead of requesting changes to avoid blocking the pull request from being merged.
+- If the PR author is ti-chi-bot, you only correct English grammar, spelling, and punctuation mistakes, if any.
+
+## Review aspects
+
+- Clarity, simplicity, completeness, and readability
+- Logical flow and sentence structure
+- Technical accuracy and terminology consistency
+
+## General writing principles
+
+- Correct English grammar, spelling, and punctuation mistakes, if any.
+- Make sure the documentation is easy to understand for TiDB users.
+- Write in **second person** ("you") when addressing users.
+- Prefer **present tense** unless describing historical behavior.
+- Avoid unnecessary words and repetition.
+- Use **consistent terminology**. For example:
+
+    - ❌ Do not mix "database" and "instance"
+    - ✅ Use "replicate" instead of "synchronize" when referring to replicating data from one TiDB cluster to another.
+
+## Structure and format
+
+- Use sentence case for headings (e.g., `## Configure the cluster`).
+- Use ordered lists (`1.`, `2.`) for steps.
+- Code snippets, command names, options, and paths should be in backticks (`` ` ``).
+
+## Markdown style
+
+- Add a blank line before and after headings and lists.
+- Use proper heading hierarchy (no jumping from `##` to `####`).
+
+## Common issues to flag
+
+- Passive voice overuse
+
+    _"The cluster is started by TiUP"_ → _"TiUP starts the cluster"_
+
+- Inconsistent use of technical terms
+
+    _"TiDB Cloud Serverless clusters" vs. "TiDB Serverless clusters"_ – pick one.
+
+- Unclear step instructions
+
+     _"Do it like before"_ → _"Repeat step 3 using the updated config file"_
+
+- Grammar and spelling issues
+
+    _"recieve"_ → _"receive"_, _"an TiDB instance"_ → _"a TiDB instance"_
+
+## Special notes
+
+- Follow any existing terminology in our glossary (`/glossary.md` if available).
+- When in doubt, favor clarity over cleverness.
+- If something might confuse a new user, suggest a reword.
+
+## Purposes of this style guide
+
+This guide helps Gemini Code Assist provide actionable, high-quality suggestions for improving technical documentation, especially for PRs related to user guides, how-to articles, and product reference material.

.github/workflows/ci.yaml

@@ -59,14 +59,14 @@ jobs:
       - name: Checkout
         uses: actions/checkout@v4
       - name: Vale Linter
-        uses: errata-ai/vale-action@v2.0.1
+        uses: errata-ai/vale-action@reviewdog
         with:
           # Optional
           # Specify file path to lint
           #files: .
 
           # Optional
-          onlyAnnotateModifiedLines: true
+          filter_mode: added
         env:
           # Required, set by GitHub actions automatically:
           # https://docs.github.com/en/actions/security-guides/automatic-token-authentication#about-the-github_token-secret

.github/workflows/dispatch.yml

@@ -6,6 +6,7 @@ on:
       - ".github/**"
     branches:
       - master
+      - release-8.1
       - release-7.2
       - release-7.1
       - release-7.0

.github/workflows/link-fail-fast.yaml

@@ -17,10 +17,6 @@ jobs:
           CHANGED_FILES=$(git diff-tree --name-only --diff-filter 'AM' -r HEAD^1 HEAD -- "*.md" | sed -z "s/\n$//;s/\n/' '/g")
           echo "all_changed_files=${CHANGED_FILES}" >> $GITHUB_OUTPUT
 
-      - name: Download Exclude Path
-        run: |
-          curl https://raw.githubusercontent.com/pingcap/docs/master/.lycheeignore -O
-
       - name: Link Checker
         if: ${{ steps.changed-files.outputs.all_changed_files }}
         uses: lycheeverse/[email protected]

.github/workflows/media.yml

@@ -7,7 +7,7 @@ on:
     paths:
       - media/**
 jobs:
-  run:
+  upload:
     name: Upload media files
     runs-on: ubuntu-latest
     steps:
@@ -34,3 +34,42 @@ jobs:
       #    printf "%s\n" ${{ secrets.AWS_ACCESS_KEY }} ${{ secrets.AWS_SECRET_KEY }} ${{ secrets.AWS_REGION }} "json" | aws configure
       - name: Upload
         run: cloud-assets-utils verify-and-sync -qiniu true -qiniu-bucket ${{ secrets.QINIU_BUCKET_NAME }} media -replace-first-path-to images/docs -cdn-refresh https://download.pingcap.com/
+
+      - name: Install coscli
+        run: |
+          wget https://cosbrowser.cloud.tencent.com/software/coscli/coscli-linux-amd64
+          mv coscli-linux-amd64 coscli
+          chmod 755 coscli
+
+      - name: Upload to COS
+        run: |
+          ./coscli sync media/ cos://${{ secrets.TENCENTCLOUD_BUCKET_ID }}/media/images/docs \
+            --init-skip \
+            --recursive \
+            --routines 16 \
+            --secret-id ${{ secrets.TENCENTCLOUD_SECRET_ID }} \
+            --secret-key ${{ secrets.TENCENTCLOUD_SECRET_KEY }} \
+            --endpoint cos.ap-beijing.myqcloud.com
+
+  cdn-refresh:
+    needs: upload
+    runs-on: ubuntu-latest
+    name: Refresh CDN Cache
+    env:
+      TENCENTCLOUD_SECRET_ID: ${{ secrets.TENCENTCLOUD_SECRET_ID }}
+      TENCENTCLOUD_SECRET_KEY: ${{ secrets.TENCENTCLOUD_SECRET_KEY }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python environment
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+          architecture: "x64"
+
+      - name: Install Tencent Cloud CLI
+        run: pipx install tccli
+
+      - name: Purge production CDN cache
+        run: tccli cdn PurgePathCache --Paths '["https://docs-download.pingcap.com/media/images/docs/"]' --FlushType delete

.lycheeignore

@@ -14,4 +14,22 @@ file://.*?http:/\$%7BPD_IP%7D:\$%7BPD_PORT%7D/dashboard.*
 http://\{grafana-ip\}:3000
 http://\{pd-ip\}:2379/dashboard
 http://localhost:\d+/
-https://github\.com/\$user/(docs|docs-cn)
+https://github\.com/\$user/(docs|docs-cn)
+https://linux\.die\.net/man.*
+https://dev\.mysql\.com/doc/.+/5.7/en/.*
+https://dev\.mysql\.com/doc/.+/8\.0/en/.*
+https://dev\.mysql\.com/doc/.+/8\.4/en/.*
+https://dev\.mysql\.com/doc/[a-z\-]+/en/.*
+https://dev\.mysql\.com/doc/relnotes/[a-z\-]+/en/.*
+https://dev\.mysql\.com/doc/dev/mysql-server/.*
+https://dev\.mysql\.com/downloads/.*
+https://bugs\.mysql\.com/bug\.php.*
+https://www\.mysql\.com/products/.*
+https://platform\.openai\.com/docs/.*
+https://openai\.com/.*
+https://jwt\.io/
+https://typeorm\.io/.*
+https://dash\.cloudflare\.com/.*
+https://centminmod\.com/mydumper\.html
+https://docs\.pingcap\.com/tidb/v6\.6/system-variables#tidb_pessimistic_txn_aggressive_locking-new-in-v660
+https://docs\.pingcap\.com/tidb/v7\.6/system-variables#tidb_ddl_version-new-in-v760

OWNERS

@@ -1,31 +1,32 @@
 # See the OWNERS docs at https://go.k8s.io/owners
 approvers:
   - breezewish
-  - CaitinChen
-  - CharLotteiu
-  - cofyc
   - csuzhangxc
-  - DanielZhangQD
-  - dcalvin
-  - dragonly
-  - en-jin19
   - hfxsd
   - Icemap
   - jackysp
   - kissmydb
   - lance6716
-  - lichunzhu
   - lilin90
-  - Liuxiaozhen12
-  - morgo
   - Oreoxmt
   - overvenus
   - qiancai
+  - tangenta
+emeritus_approvers:
+  - CaitinChen
+  - CharLotteiu
+  - cofyc
+  - DanielZhangQD
+  - dcalvin
+  - dragonly
+  - en-jin19
+  - lichunzhu
+  - Liuxiaozhen12
+  - morgo
   - queenypingcap
   - ran-huang
   - shichun-0415
   - SunRunAway
-  - tangenta
   - TomShawn
   - toutdesuite
   - WangXiangUSTC

README.md

@@ -28,6 +28,7 @@ Currently, we maintain the following versions of TiDB documentation in different
 | Branch name | TiDB docs version |
 | :---------|:----------|
 | [`master`](https://github.com/pingcap/docs/tree/master) | The latest development version |
+| [`release-8.1`](https://github.com/pingcap/docs/tree/release-8.1) | 8.1 LTS (Long-Term Support) |
 | [`release-8.0`](https://github.com/pingcap/docs/tree/release-8.0) | 8.0 Development Milestone Release |
 | [`release-7.6`](https://github.com/pingcap/docs/tree/release-7.6) | 7.6 Development Milestone Release |
 | [`release-7.5`](https://github.com/pingcap/docs/tree/release-7.5) | 7.5 LTS (Long-Term Support) |