From 3fe2113b5723229019c1875671204bc32ce7e33b Mon Sep 17 00:00:00 2001 From: Qiming Teng Date: Tue, 3 Nov 2020 10:36:16 +0800 Subject: [PATCH] Update requirements for ZH localization This PR updates the ZH localization guide on updating existing translations. --- content/zh/docs/contribute/localization_zh.md | 20 +++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/content/zh/docs/contribute/localization_zh.md b/content/zh/docs/contribute/localization_zh.md index cd146f6c58..38e5ee8000 100644 --- a/content/zh/docs/contribute/localization_zh.md +++ b/content/zh/docs/contribute/localization_zh.md @@ -226,6 +226,26 @@ Please check [installation caveats](https://acme.com/docs/v1/caveats) ... 英文排比句式中采用的逗号,在译文中要使用顿号代替,复合中文书写习惯。 +## 更新译文 + +由于整个文档站点会随着 Kubernetes 项目的开发进展而演化,英文版本的网站内容 +会不断更新。鉴于中文站点的基本翻译工作在 1.19 版本已完成,从 1.20 版本开始 +本地化的工作会集中在追踪英文内容变化上。 + +为确保准确跟踪中文化版本与英文版本之间的差异,中文内容的 PR 所包含的每个页面 +都必须是“最新的”。这里的“最新”指的是对应的英文页面中的更改已全部同步到中文页面。 +如果某中文 PR 中包含对 `content/zh/docs/foo/bar.md` 的更改,且文件 `bar.md` 的 +上次更改日期是 `2020-10-01 01:02:03 UTC`,对应 GIT 标签 `abcd1234`,则 +`bar.md` 应包含自 `abcd1234` 以来 `content/en/docs/foo/bar.md` 的所有变更, +否则视此 PR 为不完整 PR,会破坏我们对上游变更的跟踪。 + +这一要求适用于所有更改,包括拼写错误、格式更正、链接修订等等。要查看文件 +`bar.md` 上次提交以来发生的所有变更,可使用: + +``` +./scripts/lsync.sh content/zh/docs/foo/bar.md +``` + ## 关于链接 ### 链接锚点