docs(i18n): address PR #172 review — terminology rulings and register fixes

#172 评审意见整改(修复落在本 stack 上层,随 stack 合入):
enforcement frontier 裁定为「执行红线」(与金标样例⑦一致),
「强制边界」入不要译作列,消除 translation-rules 与术语表的矛盾;
orphan 裁定为「遗留」(崔),孤立/孤儿均入禁项,orphan branch 仍
沿用 git 官方「孤立分支」;README.zh 推进段与 translation-rules.zh
的门禁句按金标语体重写(崔);style-samples ⑥ 的「文件内容完全一
致」改为准确描述 blob hash 与伴随记录的比对机制(bot)。
This commit is contained in:
Ziya
2026-07-12 23:10:43 -07:00
parent 8befd9b88c
commit 8a53f3d6f9
6 changed files with 7 additions and 7 deletions
+1 -1
View File
@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write
README.md: 94c8ad9e3a83b490a854dce69b27bd7e13d834b5
README.zh.md: 4c66da76feff1b1a6c175da62cbd986838b3577e
README.zh.md: 5ed960a4dbf48d3f9b2f681298fd4d7487ca3eaf
+1 -1
View File
@@ -44,7 +44,7 @@
- `docs/i18n/terminology.md` 与 [style-samples.md](style-samples.md)——二者本身即为中英对照文档。
- [translation-prompt.md](translation-prompt.md)——自动翻译流水线的 prompt 模板;正文逐字进入模型请求,配对翻译会改变流水线行为。
**推进**:新文档不等批次——文件名带日期的文档(`yyyy-mm-dd-*.md`,即 RFC日期在 manifest 的 `requiredSince` 当天或之后,就必须连同配对一起合入,新增的一切生来即是双语。日期早于 cutoff 的文件按定义属于豁免的存量——包括 cutoff 前夜创建的文件——而文件名日期按 RFC 惯例即首次提出日期,倒填日期绕过 cutoff 是评审可见的违规,不是漏洞。对于存量文档,manifest 中的 `required` 列表是强制边界,不是目标目标是范围内的全量双语覆盖。配对按可评审的批次落地(核心入口文档、cookbook、RFC、postmortem……);每个批次合入后把文件加进 `required`,门禁只进不退。尚未进入 `required` 的文档是 backlog——在 `--list` 中可见——但任何已存在的配对无论在不在清单都按完整契约检查。一篇文档配对是一份承诺:此后任一侧的每次修改都必须带上另一侧,所以边界的扩张要跟上翻译评审的实际投入节奏,不要抢在前面
**推进**:新文档不再等待批量翻译。以日期命名的文档(`yyyy-mm-dd-*.md`,即 RFC,只要标注日期等于或晚于 manifest 的 `requiredSince` 分界日期,合入时就必须配齐双语配对——所有新文档从创建起就要求双语齐备。日期早于分界的文件按定义属于豁免的存量(包括分界前夜创建的文件);文件名日期按 RFC 惯例即首次提出日期,倒填日期绕过分界属于评审可见的违规,构不成漏洞。对于存量文档,manifest 中的 `required` 列表只是当下的执行红线,并非最终目标目标是范围内的全量双语覆盖。配对按可评审的批次落地(核心入口文档、实操手册(cookbook、RFC、事故复盘(postmortem)等);每个批次合入后把对应文件加进 `required`,门禁只向前收紧、不倒退放宽。尚未进入 `required` 的文档是待翻清单(backlog),可通过 `--list` 查看;但任何已存在的配对无论是否在清单内,都按完整契约检查。一篇文档建立配对等同于一份长期承诺:此后修改任一侧,都必须同步更新另一侧。因此执行红线的推进节奏要匹配翻译评审的实际投入,切勿超前铺开
## 分工
+1 -1
View File
@@ -66,7 +66,7 @@
> Comparing git timestamps of the pair (no record) — rejected: formatting-only edits would false-positive, and a counterpart committed after an unrelated edit would false-negative; content identity is the only signal that means what the gate claims.
对比双语文件的 git 时间戳(无哈希记录方案)——不予采纳:仅调整格式的改动会触发误报,无关修改后再提交译文又会造成漏检。只有文件内容完全一致,才能作为门禁可信的校验依据
对比双语文件的 git 时间戳(无记录方案)——不予采纳:仅调整格式的改动会触发误报,无关修改后再提交译文又会造成漏检。只有基于内容本身的标识(每侧文件的 blob hash 与伴随记录比对),才能承载门禁所声称的语义
## ⑦ 推进策略(长段拆分示范)
+2 -2
View File
@@ -90,7 +90,7 @@
| coverage | 覆盖率 | | | |
| crash recovery | 崩溃恢复 | | | |
| durability | 持久性 | | | |
| enforcement frontier | 强制边界 | | | i18n 配对机制用语:manifest `required` 清单所划的门禁生效范围 |
| enforcement frontier | 执行红线 | | 强制边界 | i18n 配对机制用语:manifest `required` 清单所划的门禁生效范围;与金标样例(style-samples ⑦)一致 |
| event | 事件 | | | |
| event log | 事件日志 | | | |
| event stream | 事件流 | | | |
@@ -118,7 +118,7 @@
| mod | 模组 | | | |
| model provider | 模型提供方 | | | |
| module | 模块 | | | |
| orphan | 孤立 | | 孤儿 | 指英文源已不存在的 `.zh.md` |
| orphan | 遗留 | | 孤儿、孤立 | 指英文源已不存在的 `.zh.md`(如「遗留译文」);进程语境按 OS 惯用语译「孤儿进程」 |
| orphan branch | 孤立分支 | | 孤儿分支 | 沿用 git 官方中文翻译 |
| pairing | 配对 | | | |
| permission | 权限 | | | |
+1 -1
View File
@@ -3,4 +3,4 @@
# after editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write
translation-rules.md: 3e99aa5432ccd904f702238e9b802a9ed9bf6832
translation-rules.zh.md: 0ff2ab43d59c6e0dd07e20e2f1a0a1c28c2f245c
translation-rules.zh.md: 1d8dcb04f1015af2db46c2e25b44f5cd147b6ecc
+1 -1
View File
@@ -21,7 +21,7 @@
## 结构保持
形状由配对门禁强制,译者不需要用流畅度去换结构——在框架内自然行文即可。配对的两个文件必须在以下方面一一对应:
结构一致性由配对门禁负责校验,译者无需为保持结构而牺牲行文的流畅:在既定框架内自然书写即可。配对的两个文件必须在以下方面一一对应:
- 标题层级(相同级别、相同顺序;标题的**文字**要翻译);
- 列表形态与编号;