diff --git a/docs/01-why-tokens-matter.md b/docs/01-why-tokens-matter.md index 79825b2..3660e1f 100644 --- a/docs/01-why-tokens-matter.md +++ b/docs/01-why-tokens-matter.md @@ -1,5 +1,7 @@ # Part 1: Why Tokens Matter +[English](01-why-tokens-matter.md) | [繁體中文（台灣）](01-why-tokens-matter.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/01-why-tokens-matter.zh-TW.md b/docs/01-why-tokens-matter.zh-TW.md index f77f8d5..0acce69 100644 --- a/docs/01-why-tokens-matter.zh-TW.md +++ b/docs/01-why-tokens-matter.zh-TW.md @@ -58,7 +58,7 @@ Token 是大型語言模型讀寫時使用的基本單位。它不是單字， │ ┌──────────────────┐ ┌─────────────────────┐ │ │ │ INPUT TOKENS │ │ OUTPUT TOKENS │ │ │ │ │ │ │ │ -│ │ System prompt │ │ 你收到的回應 │ │ +│ │ System prompt │ │ 你收到的回應 │ │ │ │ + copilot- │ │ │ │ │ │ instructions │ │ │ │ │ │ + file context │ │ │ │ diff --git a/docs/02-prompt-compression.md b/docs/02-prompt-compression.md index dc3de6b..1aae29a 100644 --- a/docs/02-prompt-compression.md +++ b/docs/02-prompt-compression.md @@ -1,5 +1,7 @@ # 2.1 Prompt Compression — Say the Same Thing in Fewer Tokens +[English](02-prompt-compression.md) | [繁體中文（台灣）](02-prompt-compression.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/03-language-comparison.md b/docs/03-language-comparison.md index 5263b9d..b4d6ba7 100644 --- a/docs/03-language-comparison.md +++ b/docs/03-language-comparison.md @@ -1,5 +1,7 @@ # 2.2 Natural Language Choice — Checking the CJK Assumption +[English](03-language-comparison.md) | [繁體中文（台灣）](03-language-comparison.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/04-context-management.md b/docs/04-context-management.md index 97c9d7d..53666bb 100644 --- a/docs/04-context-management.md +++ b/docs/04-context-management.md @@ -1,5 +1,7 @@ # 2.3 Context Management — Control What Gets Sent +[English](04-context-management.md) | [繁體中文（台灣）](04-context-management.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/05-output-control.md b/docs/05-output-control.md index a7d11ab..0cacf3a 100644 --- a/docs/05-output-control.md +++ b/docs/05-output-control.md @@ -1,5 +1,7 @@ # 2.4 Output Control — Tell the Model What NOT to Say +[English](05-output-control.md) | [繁體中文（台灣）](05-output-control.zh-TW.md) + [← Back to Guide](index.md) > **Why this section matters most for cost.** Output tokens cost **5× more per token** than input tokens across all Anthropic/Copilot UBB pricing tiers. Even though responses are typically smaller in volume than total input (which includes file context, history, and tool schemas), the pricing asymmetry makes output control the highest per-token ROI action in this guide. One line in `copilot-instructions.md` — "Code only, no explanation" — cuts output cost by 40–70% on every code task, permanently. diff --git a/docs/06-workflow-optimization.md b/docs/06-workflow-optimization.md index ca89e33..d652f64 100644 --- a/docs/06-workflow-optimization.md +++ b/docs/06-workflow-optimization.md @@ -1,5 +1,7 @@ # 2.5 Workflow-Specific Optimization +[English](06-workflow-optimization.md) | [繁體中文（台灣）](06-workflow-optimization.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/07-agents-md-problem.md b/docs/07-agents-md-problem.md index a6267e5..a950c59 100644 --- a/docs/07-agents-md-problem.md +++ b/docs/07-agents-md-problem.md @@ -1,5 +1,7 @@ # 2.6 The Always-On Context Problem — Why Less Is More +[English](07-agents-md-problem.md) | [繁體中文（台灣）](07-agents-md-problem.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/08-mcp-tool-costs.md b/docs/08-mcp-tool-costs.md index 731e4cb..faff10b 100644 --- a/docs/08-mcp-tool-costs.md +++ b/docs/08-mcp-tool-costs.md @@ -1,5 +1,7 @@ # 2.7 Tool & MCP Server Costs — The Hidden Token Tax +[English](08-mcp-tool-costs.md) | [繁體中文（台灣）](08-mcp-tool-costs.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/09-comparisons-data.md b/docs/09-comparisons-data.md index d4cb876..86ded51 100644 --- a/docs/09-comparisons-data.md +++ b/docs/09-comparisons-data.md @@ -1,5 +1,7 @@ # Part 3: Comparisons & Data +[English](09-comparisons-data.md) | [繁體中文（台灣）](09-comparisons-data.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/10-practical-setup.md b/docs/10-practical-setup.md index db5dcda..dd382cf 100644 --- a/docs/10-practical-setup.md +++ b/docs/10-practical-setup.md @@ -1,5 +1,7 @@ # Part 4: Practical Setup +[English](10-practical-setup.md) | [繁體中文（台灣）](10-practical-setup.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/11-models-and-pricing.md b/docs/11-models-and-pricing.md index 811ba5c..e1eb8a2 100644 --- a/docs/11-models-and-pricing.md +++ b/docs/11-models-and-pricing.md @@ -1,5 +1,7 @@ # Model Selection & Pricing +[English](11-models-and-pricing.md) | [繁體中文（台灣）](11-models-and-pricing.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/12-enterprise-governance.md b/docs/12-enterprise-governance.md index 06a1eb7..3262b2f 100644 --- a/docs/12-enterprise-governance.md +++ b/docs/12-enterprise-governance.md @@ -1,5 +1,7 @@ # Enterprise Governance for Copilot Cost Control +[English](12-enterprise-governance.md) | [繁體中文（台灣）](12-enterprise-governance.zh-TW.md) + [← Back to Guide](index.md) --- diff --git a/docs/index.md b/docs/index.md index ad8c4d9..ddb4e09 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,5 +1,7 @@ # Token Optimization Guide +[English](index.md) | [繁體中文（台灣）](index.zh-TW.md) + Practical guide to reducing GitHub Copilot token spend while keeping answers and code useful. [Start with Part 1](01-why-tokens-matter.md){ .md-button .md-button--primary } diff --git a/mkdocs.yml b/mkdocs.yml index 6141434..252b8c3 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -28,20 +28,40 @@ markdown_extensions: extra_css: - stylesheets/extra.css nav: - - Home: index.md - - Part 1: - - Why Tokens Matter: 01-why-tokens-matter.md - - Part 2: - - Prompt Compression: 02-prompt-compression.md - - Language Comparison: 03-language-comparison.md - - Context Management: 04-context-management.md - - Output Control: 05-output-control.md - - Workflow Optimization: 06-workflow-optimization.md - - Always-On Context Problem: 07-agents-md-problem.md - - MCP & Tool Costs: 08-mcp-tool-costs.md - - Part 3: - - Comparisons & Data: 09-comparisons-data.md - - Part 4: - - Practical Setup: 10-practical-setup.md - - Model Selection & Pricing: 11-models-and-pricing.md - - Enterprise Governance: 12-enterprise-governance.md + - Home: + - English: index.md + - 繁體中文（台灣）: index.zh-TW.md + - English Guide: + - Part 1: + - Why Tokens Matter: 01-why-tokens-matter.md + - Part 2: + - Prompt Compression: 02-prompt-compression.md + - Language Comparison: 03-language-comparison.md + - Context Management: 04-context-management.md + - Output Control: 05-output-control.md + - Workflow Optimization: 06-workflow-optimization.md + - Always-On Context Problem: 07-agents-md-problem.md + - MCP & Tool Costs: 08-mcp-tool-costs.md + - Part 3: + - Comparisons & Data: 09-comparisons-data.md + - Part 4: + - Practical Setup: 10-practical-setup.md + - Model Selection & Pricing: 11-models-and-pricing.md + - Enterprise Governance: 12-enterprise-governance.md + - 繁體中文指南: + - Part 1: + - 為什麼 Token 很重要: 01-why-tokens-matter.zh-TW.md + - Part 2: + - Prompt 壓縮: 02-prompt-compression.zh-TW.md + - 語言比較: 03-language-comparison.zh-TW.md + - Context 管理: 04-context-management.zh-TW.md + - 輸出控制: 05-output-control.zh-TW.md + - Workflow 最佳化: 06-workflow-optimization.zh-TW.md + - Always-On Context 問題: 07-agents-md-problem.zh-TW.md + - MCP 與工具成本: 08-mcp-tool-costs.zh-TW.md + - Part 3: + - 比較與數據: 09-comparisons-data.zh-TW.md + - Part 4: + - 實際設定: 10-practical-setup.zh-TW.md + - 模型選擇與定價: 11-models-and-pricing.zh-TW.md + - 企業治理: 12-enterprise-governance.zh-TW.md