Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/01-why-tokens-matter.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 1 addition & 1 deletion docs/01-why-tokens-matter.zh-TW.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Token 是大型語言模型讀寫時使用的基本單位。它不是單字,
│ ┌──────────────────┐ ┌─────────────────────┐ │
│ │ INPUT TOKENS │ │ OUTPUT TOKENS │ │
│ │ │ │ │ │
│ │ System prompt │ │ 你收到的回應 │ │
│ │ System prompt │ │ 你收到的回應 │ │
│ │ + copilot- │ │ │ │
│ │ instructions │ │ │ │
│ │ + file context │ │ │ │
Expand Down
2 changes: 2 additions & 0 deletions docs/02-prompt-compression.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/03-language-comparison.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/04-context-management.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/05-output-control.md
Original file line number Diff line number Diff line change
@@ -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.
Expand Down
2 changes: 2 additions & 0 deletions docs/06-workflow-optimization.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/07-agents-md-problem.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/08-mcp-tool-costs.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/09-comparisons-data.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Part 3: Comparisons & Data

[English](09-comparisons-data.md) | [繁體中文(台灣)](09-comparisons-data.zh-TW.md)

[← Back to Guide](index.md)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/10-practical-setup.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
# Part 4: Practical Setup

[English](10-practical-setup.md) | [繁體中文(台灣)](10-practical-setup.zh-TW.md)

[← Back to Guide](index.md)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/11-models-and-pricing.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/12-enterprise-governance.md
Original file line number Diff line number Diff line change
@@ -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)

---
Expand Down
2 changes: 2 additions & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
@@ -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 }
Expand Down
54 changes: 37 additions & 17 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -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