test: Update command-line-flags-for-tidb-configuration.md

[qiancai]

First-time contributors' checklist

• I've signed the Contributor License Agreement, which is required for the repository owners to accept my contribution.

What is changed, added or deleted? (Required)

Which TiDB version(s) do your changes apply to? (Required)

Tips for choosing the affected version(s):

By default, CHOOSE MASTER ONLY so your changes will be applied to the next TiDB major or minor releases. If your PR involves a product feature behavior change or a compatibility change, CHOOSE THE AFFECTED RELEASE BRANCH(ES) AND MASTER.

For details, see tips for choosing the affected versions (in Chinese).

• master (the latest development version)
• v9.0 (TiDB 9.0 versions)
• v8.5 (TiDB 8.5 versions)
• v8.1 (TiDB 8.1 versions)
• v7.5 (TiDB 7.5 versions)
• v7.1 (TiDB 7.1 versions)
• v6.5 (TiDB 6.5 versions)
• v6.1 (TiDB 6.1 versions)
• v5.4 (TiDB 5.4 versions)

What is the related PR or file link(s)?

• This PR is translated from: test: Update command-line-flags-for-tidb-configuration.md docs-cn#14
• Other reference link(s):

Do your changes match any of the following descriptions?

• Delete files
• Change aliases
• Need modification after applied to another branch
• Might cause conflicts after applied to another branch

Summary by CodeRabbit

• Documentation
  • Corrected mislabeled security configuration options for certificate and CA file to match their intended meanings.
  • Clarified descriptions for certificate (PEM/X.509) and CA certificate paths to prevent configuration confusion.
  • Updated metric section wording to explicitly reference “metric,” improving clarity and consistency.
  • Ensured defaults remain unchanged while improving accuracy and readability of configuration guidance.

[gemini-code-assist]

Note

Gemini is unable to generate a summary for this pull request due to the file types involved not being currently supported.

[github-actions]

🤖 Auto-sync completed successfully

📥 Source PR: qiancai/docs-cn#14
🎯 Target PR: #42
✅ English documentation has been updated based on Chinese documentation changes.

This comment was generated automatically by the sync workflow.

[coderabbitai]

Walkthrough

Documentation edits in tso-configuration-file.md: swapped the labels/descriptions for cert-path and cacert-path in the security section without changing defaults, and adjusted the metric section description to use backticks around “metric.”

Changes

Cohort / File(s)	Summary of Changes
Documentation updates tso-configuration-file.md	Swapped headings and descriptions for cert-path and cacert-path in security config; updated metric section description to “Configuration items related to metric.”

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~8 minutes

Poem

I twitch my ears at docs so neat,
Certs swapped places—hop, repeat!
Metrics in backticks, tidy and bright,
A nibble of clarity, set just right.
Thump-thump approves—merge tonight! 🐇✨

Pre-merge checks and finishing touches

❌ Failed checks (2 warnings)

Check name	Status	Explanation	Resolution
Title Check	⚠️ Warning	The title “test: Update command-line-flags-for-tidb-configuration.md” does not match the actual changes, which modify certificate path labels in tso-configuration-file.md. It includes an irrelevant file name and a noisy “test:” prefix, making it unclear and misleading. A concise summary of the main modification would improve clarity.	Please update the title to concisely reflect the primary change, for example “Swap cert-path and cacert-path labels in tso-configuration-file.md,” removing the “test:” prefix and specifying the actual file and change made.
Description Check	⚠️ Warning	The PR description includes the template and headings but leaves all key sections blank, failing to describe the changes made or the versions affected. The contributor checklist and version checkboxes are present but not filled out, so readers have no insight into the change rationale or scope. This makes the description incomplete and unhelpful for reviewers.	Please complete the "What is changed, added or deleted?" section with a clear summary of the modifications and mark the appropriate TiDB version checkboxes. Update the contributor checklist to reflect CLA status and remove or properly use any unused sections. Add context for the related PR link and specify if any backport or alias changes are required.

✅ Passed checks (1 passed)

Check name	Status	Explanation
Docstring Coverage	✅ Passed	No functions found in the changes. Docstring coverage check skipped.

✨ Finishing touches

🧪 Generate unit tests

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch test-update-14

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 0

🧹 Nitpick comments (2)

tso-configuration-file.md (2)

63-71: Clarify the certificate file descriptions

Let’s tighten the prose so readers immediately know which file each path should point to.

-### `cert-path`
-
-- The path of the Privacy Enhanced Mail (PEM) file that contains the X.509 certificate
+### `cert-path`
+
+- Path to the PEM-encoded X.509 certificate file for this TSO node.
 - Default value: ""
 
 ### `cacert-path`
 
-- The path of the CA file
+- Path to the CA certificate bundle used to validate incoming certificates.
 - Default value: ""

---

130-130: Avoid backticks around non-code terms

“metric” here isn’t a literal option name, so the backticks make the sentence feel awkward. We can keep it plain English.

-Configuration items related to `metric`.
+Configuration items related to metrics.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between 7dbc37b and 4249d87.

📒 Files selected for processing (1)

• tso-configuration-file.md (2 hunks)

🧰 Additional context used

📓 Path-based instructions (1)

**/*.md

⚙️ CodeRabbit configuration file

As a technical writer in the database area, you need to first learn the changes in this PR, and then improve the content to make it clear, concise, and easy to understand in English according to your database knowledge.

Files:

• tso-configuration-file.md