From 1d45f9bb577afba00155b578c983d7c7c61abc10 Mon Sep 17 00:00:00 2001 From: Roo Code Date: Tue, 12 Aug 2025 15:47:17 +0000 Subject: [PATCH 1/3] docs: update zh-TW translation instructions based on PR #6946 learnings - Added comprehensive terminology mapping with notes - Included new terms learned from native speaker improvements - Added consistency guidelines for formality and punctuation - Provided examples of good vs bad translations - Added review checklist for quality assurance Based on improvements by @PeterDaveHello in PR #6946 --- .roo/rules-translate/instructions-zh-tw.md | 93 ++++++++++++++++++++-- 1 file changed, 85 insertions(+), 8 deletions(-) diff --git a/.roo/rules-translate/instructions-zh-tw.md b/.roo/rules-translate/instructions-zh-tw.md index ee4d07a07a4..3f19785c2d9 100644 --- a/.roo/rules-translate/instructions-zh-tw.md +++ b/.roo/rules-translate/instructions-zh-tw.md @@ -2,17 +2,94 @@ ## Key Terminology -| English Term | Use (zh-TW) | Avoid (Mainland) | -| ------------- | ----------- | ---------------- | -| file | 檔案 | 文件 | -| task | 工作 | 任務 | -| project | 專案 | 項目 | -| configuration | 設定 | 配置 | -| server | 伺服器 | 服務器 | -| import/export | 匯入/匯出 | 導入/導出 | +| English Term | Use (zh-TW) | Avoid (Mainland) | Notes | +| ------------- | ------------- | ---------------- | -------------------------------- | +| file | 檔案 | 文件 | | +| task | 工作 | 任務 | | +| project | 專案 | 項目 | | +| configuration | 設定 | 配置 | | +| server | 伺服器 | 服務器 | | +| import/export | 匯入/匯出 | 導入/導出 | | +| account | 帳號 | 帳戶 | Use 帳號 for user accounts | +| connect | 連線 | 連接 | Use 連線 for network connections | +| sign in | 登入 | 連接到 | Use 登入 for authentication | +| history | 歷史紀錄 | 歷史 | Add 紀錄 for clarity | +| token | Token | Tokens | Keep singular form, no 's' | +| pin/unpin | 釘選/取消釘選 | 置頂/取消置頂 | Use 釘選 for UI pinning | +| enhance | 強化 | 增強 | Use 強化 for improvements | +| prompt | 提示詞 | 提示 | Add 詞 for AI prompts | +| documentation | 說明文件 | 文件 | Use 說明文件 for docs | +| endpoint | 端點 | 站點 | Use 端點 for API endpoints | +| learn more | 了解更多 | 瞭解更多 | Use simplified 了 | +| approve | 核准 | 批准 | Use 核准 for approvals | +| global | 全域 | 全局 | Use 全域 for scope | +| level | 層級 | 級 | Use 層級 for hierarchy | ## Formatting Rules - Add spaces between Chinese and English/numbers: "AI 驅動" (not "AI驅動") - Use Traditional Chinese quotation marks: 「範例文字」(not "範例文字") - Use Taiwanese computing conventions rather than mainland terminology +- Keep English technical terms (like "Token", "API") in English when commonly used +- Add spaces around English abbreviations: "API 金鑰" (not "API金鑰") + +## Consistency Guidelines + +1. **Formality Level**: Use respectful "您" instead of casual "你" for user-facing text +2. **Punctuation**: Use full-width punctuation marks (，、。！？) in Chinese text +3. **Technical Terms**: Keep commonly-used English terms (API, Token, URL) in English +4. **Clarity**: Add clarifying words when needed (e.g., 歷史紀錄 instead of just 歷史) +5. **Context**: Consider the UI context - shorter terms for buttons, clearer terms for descriptions + +## Common Patterns + +### Action Verbs + +- Create/Build: 建立 +- Delete/Remove: 刪除 +- Update/Modify: 更新 +- Save: 儲存 +- Cancel: 取消 +- Confirm: 確認 + +### UI Elements + +- Button: 按鈕 +- Menu: 選單 +- Dialog: 對話框 +- Tab: 分頁 +- Panel: 面板 +- Sidebar: 側邊欄 + +### Status Messages + +- Loading: 載入中 +- Processing: 處理中 +- Completed: 已完成 +- Failed: 失敗 +- Pending: 待處理 + +## Examples of Good Translations + +- ❌ "使用額外內容增強提示" +- ✅ "使用額外內容強化提示詞" + +- ❌ "線上工作歷歷史記錄" (typo) +- ✅ "線上工作歷史紀錄" + +- ❌ "連接到 Roo Code Cloud" +- ✅ "登入 Roo Code Cloud" (clearer intent) + +- ❌ "基於工作、Token 和成本的使用指標" +- ✅ "基於工作任務、Token 和成本的用量指標" (more precise) + +## Review Checklist + +Before submitting translations: + +- [ ] Check for typos and repeated characters +- [ ] Verify consistent terminology throughout all files +- [ ] Ensure proper spacing between Chinese and English text +- [ ] Confirm appropriate formality level (您 vs 你) +- [ ] Validate that technical terms are handled consistently +- [ ] Review context to ensure translations make sense in the UI From f7bad5c8494979f581f690c1864f27ab7f517c07 Mon Sep 17 00:00:00 2001 From: Roo Code Date: Mon, 18 Aug 2025 17:08:18 +0000 Subject: [PATCH 2/3] fix: apply PeterDaveHello's review feedback to zh-TW translation instructions MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Removed duplicate level entry from terminology table - Added note that Build translation depends on context - Added separate entries for Remove (移除) and Modify (修改) - Fixed typo in example (removed extra 歷 character) - Simplified checklist item about checking for typos Co-authored-by: PeterDaveHello --- .roo/rules-translate/instructions-zh-tw.md | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/.roo/rules-translate/instructions-zh-tw.md b/.roo/rules-translate/instructions-zh-tw.md index 3f19785c2d9..b49cbfa56f9 100644 --- a/.roo/rules-translate/instructions-zh-tw.md +++ b/.roo/rules-translate/instructions-zh-tw.md @@ -23,7 +23,6 @@ | learn more | 了解更多 | 瞭解更多 | Use simplified 了 | | approve | 核准 | 批准 | Use 核准 for approvals | | global | 全域 | 全局 | Use 全域 for scope | -| level | 層級 | 級 | Use 層級 for hierarchy | ## Formatting Rules @@ -45,9 +44,12 @@ ### Action Verbs -- Create/Build: 建立 -- Delete/Remove: 刪除 -- Update/Modify: 更新 +- Create: 建立 +- Build: 建立 (depends on context) +- Delete: 刪除 +- Remove: 移除 +- Update: 更新 +- Modify: 修改 - Save: 儲存 - Cancel: 取消 - Confirm: 確認 @@ -74,7 +76,7 @@ - ❌ "使用額外內容增強提示" - ✅ "使用額外內容強化提示詞" -- ❌ "線上工作歷歷史記錄" (typo) +- ❌ "線上工作歷史記錄" (typo) - ✅ "線上工作歷史紀錄" - ❌ "連接到 Roo Code Cloud" @@ -87,7 +89,7 @@ Before submitting translations: -- [ ] Check for typos and repeated characters +- [ ] Check for typos - [ ] Verify consistent terminology throughout all files - [ ] Ensure proper spacing between Chinese and English text - [ ] Confirm appropriate formality level (您 vs 你) From 3ed0a5646545c3129d7bbb33bebafb391f3a9d81 Mon Sep 17 00:00:00 2001 From: daniel-lxs Date: Mon, 18 Aug 2025 17:39:26 -0500 Subject: [PATCH 3/3] =?UTF-8?q?docs(zh-TW):=20apply=20@PeterDaveHello=20su?= =?UTF-8?q?ggestions=20=E2=80=94=20Build=E2=86=92=E5=BB=BA=E7=BD=AE;=20rem?= =?UTF-8?q?ove=20ambiguous=20'learn=20more'=20note?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .roo/rules-translate/instructions-zh-tw.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/.roo/rules-translate/instructions-zh-tw.md b/.roo/rules-translate/instructions-zh-tw.md index b49cbfa56f9..131213069ff 100644 --- a/.roo/rules-translate/instructions-zh-tw.md +++ b/.roo/rules-translate/instructions-zh-tw.md @@ -20,7 +20,6 @@ | prompt | 提示詞 | 提示 | Add 詞 for AI prompts | | documentation | 說明文件 | 文件 | Use 說明文件 for docs | | endpoint | 端點 | 站點 | Use 端點 for API endpoints | -| learn more | 了解更多 | 瞭解更多 | Use simplified 了 | | approve | 核准 | 批准 | Use 核准 for approvals | | global | 全域 | 全局 | Use 全域 for scope | @@ -45,7 +44,7 @@ ### Action Verbs - Create: 建立 -- Build: 建立 (depends on context) +- Build: 建置 - Delete: 刪除 - Remove: 移除 - Update: 更新