Skip to content

docs(design): review translated quantities for readable meaning - #7417

Merged
huangruiteng merged 1 commit into
mainfrom
codex/research-translation-reading-contract-20261027
Oct 26, 2026
Merged

huangruiteng merged 1 commit into
mainfrom
codex/research-translation-reading-contract-20261027

Conversation

@loopx-agent

Copy link
Copy Markdown
Collaborator

Research translations can have complete field coverage and preserve every source token while leaving quantities hidden in opaque English compounds. The design contract now asks authors and reviewers to compare actual saved text with its original and cited context, explain supported quantities in the interface language, and preserve unresolved counts, units and identifiers without guessing.

The existing populated-page review applies this check to saved output. Corrections continue through the existing versioned analysis owner; the rule adds no model execution or saved-result rewriting. This proposal changes the acceptance guidance, not existing translations or application rendering.

Validation at efbb473f168075c534401b65d76cf2a311f61a7d against bf4cf4943c53a24d98065206c56c031c5277fc9d:

  • English/Chinese clause and authority review; git diff --check and public-boundary scan passed.
  • Exact-scope change-quality receipt is valid.
  • Premerge: four direct checks and nine selected checks passed, with no failures, warnings or manual holds.
  • No runtime, UI, schema or model prompt changes; first-screen rendering is unchanged.

Signed-off-by: LoopX Agent <337587101+loopx-agent@users.noreply.github.com>

@loopx-agent loopx-agent left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reviewer: model_agent · gpt-6.1-sol · OpenAI · runtime_reported · effort=max

Approval conclusion (author-owned PR; GitHub blocks formal self-approval)

动机

研究工作台的使用者,以及验收研究译文的作者和评审者。 字段和原始标记全部保留时,数量仍可能藏在英文连写串中;新规则要求对照原文与引用语境,在正文说明有依据的数量及其所指。 开发与评审有明确的原文/语境核对依据,覆盖计数不能代替可读性判断。

本PR交付规范修订,不修复或重新生成已有译文,也不改应用渲染。 既有译文的实际可读性修复和正式App采用仍须沿原工作完成。 这是一项有依据的规范增量;不以规范通过代表整个研究体验已经完成。

改动思路

保留现有设计规范、分析版本和证据所有权,只把可读含义检查补进已有评审流程。保持现状会继续让“字段齐全”掩盖正文难懂;新增评测器或审批流程又会扩大职责。当前做法要求来源支持数量解释,未知计数、单位和标识保持未决,模型执行仍依原入口授权。简单文档规则用正文说明即可,无需新增流程图或机器评分。

具体改动

关键内容讲解

本次准确 head 为 efbb473f168075c534401b65d76cf2a311f61a7d。规格依据是变更前的 docs/development/design.md,固定 revision bf4cf4943c53a24d98065206c56c031c5277fc9d;没有用本PR新增文字反向认证自身。

  • Owner language first:在译文规则中对照原文和引用语境,要求有依据的数量及其所指用界面语言表达;原始词和不确定性仍保留。
  • Research Workspace:原有分析所有权与只读边界明确保留;评审不自动重跑模型,不覆盖已存结果。
  • Populated Page Review:已有展开阅读项加入真实已保存输出核对,合成译文和覆盖计数不能单独代替这一检查。

以上三项均在本次文档范围实现。仅1个文件新增17行;没有生产代码、重复状态、测试夹具或新协议分支。

对主干的风险

最重要的误用风险,是为解释数字而猜测标识含义,或把检查译文当成重新执行分析的许可。新增中英文条款都明确禁止这些推论,沿原版本化分析处理修订。人工正反例逐句核对通过;精确范围CQR有效,原生premerge的4项直接检查与9项选中检查全部通过,0失败、0警告、0人工留置。按当前策略未读取或等待远端CI。文档可以独立回退,已有译文和应用行为保持原状;规范被阅读并不证明后续模型遵从。

我的整体评价

APPROVE / justified_increment。它给开发和评审提供了具体的正文验收依据,改动范围与该流程缺口相称。本PR只修改 docs/development/design.md 的验收说明,未改任何渲染、布局或控件。 既有译文的实际可读性与正式App采用仍由原任务验证;本PR不据规范文本推断其通过。 本评审为作者自评,不构成独立内容验收、正式App采用或合并授权。

English verdict: APPROVE for this documentation increment at efbb473f168075c534401b65d76cf2a311f61a7d. It makes source-bound translation readability explicit while preserving ambiguity, original evidence and existing execution authority. Existing translations and installed behavior remain outside this PR's qualification.

@huangruiteng
huangruiteng merged commit bd03d08 into main Oct 26, 2026
24 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants