Skip to content

glossary: improve and normalize technical Japanese terms#32

Open
yahonda wants to merge 1 commit into
pingcap:mainfrom
yahonda:fix-glossary-terms-normalization
Open

glossary: improve and normalize technical Japanese terms#32
yahonda wants to merge 1 commit into
pingcap:mainfrom
yahonda:fix-glossary-terms-normalization

Conversation

@yahonda

@yahonda yahonda commented May 22, 2026

Copy link
Copy Markdown
Member

Description

This PR improves the Japanese glossary to ensure more natural and consistent technical terms in the machine-translated documentation, focusing on high-impact terms with minimal risk of side effects.

Key Changes

  • Normalization of standard terms:
    • Updated Cluster to クラスター (standard Katakana with long vowel mark).
    • Updated Configuration to 設定 (more idiomatic than コンフィグレーション).
    • Improved phrasing for Multiple Data Centers in One City Deployment.
  • Protection of product and technical names:
    • Added Self-Managed to prevent translation into Katakana, preserving its role as part of the product name.
    • Added protection for 2xlarge through 16xlarge instance types (consistent with the existing xlarge entry) to prevent over-translation in instance type tables.
  • Avoidance of literal translations:
    • Normalized Hotspot to ホットスポット to prevent literal translations like "熱い地点".
    • Normalized Primary Cluster and Secondary Cluster phrasing.

These entries have been carefully selected to avoid conflicts with common configuration keys or code snippets while significantly improving the readability of core documentation.

@yahonda yahonda force-pushed the fix-glossary-terms-normalization branch 2 times, most recently from 9dcc6b6 to 9442b5c Compare June 2, 2026 00:50
… side effects

- Normalize Cluster to クラスター (remove long vowel inconsistency)
- Update Multiple Data Centers in One City Deployment translation
- Change Configuration to 設定 for better clarity
- Remove context-dependent entries that cause side effects:
  * Join Reorder (No.30, No.107): unnatural Japanese translation
  * Statistics (No.31): context-dependent (統計/統計学/統計情報)
  * Wrong Index Solution (No.32): too specific, better handled manually
- Add new entries: instance types (2xlarge-16xlarge), Self-Managed, Hotspot,
  Primary Cluster, Secondary Cluster
@yahonda yahonda force-pushed the fix-glossary-terms-normalization branch from 9442b5c to 5a6ab4a Compare June 2, 2026 01:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant