本地化策略

java-profiler 文档以英文为源语言。中文文档优先覆盖最重要的用户和贡献者路径，不把所有内部材料都翻译一遍。

必须双语的页面

这些页面需要同时提供英文和中文：

English	中文
/	/zh/
/getting-started/quickstart	/zh/getting-started/quickstart
/operations/performance-analysis-user-manual	/zh/operations/performance-analysis-user-manual
/contributing/development	/zh/contributing/development
/reference/profiling-contracts	/zh/reference/profiling-contracts

有英文入口、中文完整手册的运维页面：

English 入口	中文完整手册
/operations/deployment-operations-admin-manual	/zh/operations/deployment-operations-admin-manual
/operations/e2e-automation-test-guide	/zh/operations/e2e-automation-test-guide

只保留英文的页面

实现细节重、访问频率低、或偏开发过程的材料默认只保留英文：

• 架构细节。
• Ingestion 架构 review。
• E2E 自动化的详细执行步骤位于 /zh/operations，英文路径保留概览和验收边界。
• 真实 profiling 验收标准。
• Research notes。
• Brainstorms 和项目历史材料。

Research、brainstorms、plans 不进入公开导航。

翻译流程

修改必须双语的页面时：

1. 先改英文页面。
2. 同一个变更里同步中文页面。
3. 中文路径保持 /zh/ 下的同构 route。
4. 截图默认复用，除非图片里的语言会让用户误解。
5. 发布前构建文档站。

cd docs
npm run docs:build

风格

• 使用自然、清楚的技术中文，不做逐句硬翻。
• 产品名、API key、annotation、profile type、文件路径保持原样。
• UI 里显示的术语保留英文，例如 Top Table、Flame Graph、Self CPU、Total CPU。
• 不要只在中文页添加新的产品承诺。如果这个说法重要，先加到英文页。