分类: Go
-
Go Learning & Documentation v2 在长期演进中逐渐积累了 Snapshot、predecessor、promotion、authorization、receipt、identity 等大量历史状态。最初,这些历史用于复用成果和支持恢复;但当正常工作也开始依赖不断向前追溯和还原旧状态时,工程成本迅速上升。本文介绍 v2 为什么最终引入 Trusted Checkpoint / Stop Point:旧历史继续保留用于审计、诊断和必要时追溯,但正常工作流从可信当前基线继续向前,不再要求无限重建过去。
-
在 Go Learning & Documentation v2 中,历史最初存在的价值并不是为了建立复杂的追溯体系,而是为了复用已经高质量完成的翻译成果。本文介绍为什么已经通过 Generation、Machine Validation 和 Independent QC 的 TranslationUnit 不应该因为 milestone、parser 或工作流升级就被无条件重做,以及 trusted carry、machine revalidation 和异常集合处理如何减少重复翻译、重复审核和无意义的语言漂移。
-
Go Learning & Documentation v2 将 Learn / Docs 纳入翻译流程后,Markdown、inline code、链接、完整代码、教学注释等复杂结构都需要更精确的 parser 与保护机制。本文介绍为什么结构保护不能只是“锁住 token 和顺序”,而应该重点保护 pair、binding 与机器语义;同时通过 Parse / Protect、Generation、Reconstruct / Validate 的分层,让 AI 在不破坏结构的前提下,仍然能够按照目标语言自然表达。
-
Go Learning & Documentation v2 为了支持更精确的 Semantic Compatibility,引入了更复杂的状态准备与影响范围判断,但也让部分 CLI 从秒级逐渐退化到分钟级。本文记录一次实际性能优化:通过识别同一 invocation 中被反复构建的 Compatibility State,将执行方式调整为 Prepare Once / Reuse Many Times,在不改变原有判断结果、fail-closed 语义和验证范围的前提下,将一次典型命令从 6m54.554s 优化到 10.335s,约提升 40.1 倍。
-
Go Learning & Documentation v2 统一 glossary 之后,一个关键问题随之出现:术语表发生变化时,是否所有已经翻译和审核完成的页面都要重新处理?本文介绍 v2 如何从简单的 glossary SHA 变化,进一步判断 Semantic Delta、相关 Page、Compatible 与 Affected 范围,只让真正受到新术语规则影响的 TranslationUnit 进入 revision 和 re-QC,同时尽量复用已有的高质量翻译结果。
-
随着 Go Learning & Documentation v2 从 A Tour of Go 扩展到 Learn、Docs 以及未来更多 content package,术语治理也需要从 package 级调整到 locale 级。本文介绍为什么同一个 locale 最终只保留一份正式 glossary,以及 Unified Glossary、Terminology Discovery、术语复用和 future content package 之间的关系。同时说明,统一术语表并不意味着无限收录所有词汇,也不意味着 glossary 每次变化都要让全部 TranslationUnit 重新处理。
-
在 Go Learning & Documentation v2 中,Learn / Docs 的 Markdown 内容虽然可以被 parser 拆成标题、段落、列表、代码注释等更小的结构,但正式翻译与审核仍然坚持以完整 Page 作为 TranslationUnit。本文从上下文、自然语序、Independent Review、parser 演进和历史稳定性等角度,解释为什么机器内部的解析粒度不应该直接决定语言治理边界,以及 Page TranslationUnit 与 internal slot 应该如何分工。
-
A Tour of Go 多语言翻译项目正在进入 v2。随着翻译范围从 Tour 扩展到 Site shell、Learn、Docs 以及未来更多 content package,原有围绕 Tour 构建的架构已经不足以继续扩展。本文记录为什么需要 v2,以及 TranslationUnit、统一术语表、内容包、历史复用与网站集成等设计背后的整体思路。
-
在 Go 多语言翻译项目从 A Tour of Go 扩展到 Site、Learn、Docs 及 future content packages 后,原本用于避免无意义重复审核的 glossary compatibility 机制开始暴露出严重性能问题:部分 Quality Check、Reviewer Bundle、finalization 与 revision 命令需要数分钟才能完成。本文记录一次真实的架构决策过程,对比“继续优化 semantic-delta compatibility carry”和“退回 glossary SHA 变化即 full QC”两种方案,并说明为什么最终暂时保留 compatibility、采用全语言共享的 invocation-local prepared-state 优化。同时进一步确定,无论最终采用哪一种方案,提前基于更完整的 Go/go.dev 技术语境稳定 glossary,都是降低长期维护成本的关键。
-
在 A Tour of Go 简体中文版本进入发布前质量审核后,我发现 channel 在中文 Go 资料中存在“通道”“信道”“管道”以及直接保留英文等多种用法。本文记录这次术语校准过程:不再依据项目内部出现次数判断译法,而是参考中文 Go 社区长期形成的实际习惯,并进一步统一 type inference、untyped constant、built-in 等核心术语。最终形成“社区强共识、项目约定、保留原生术语”三类处理原则,并将确定的译法写入 zh-CN glossary。
