标签: 本地化
-
Go Learning & Documentation v2 在处理结构化内容时发现,一个原始文件即使字节完全没有变化,也不代表旧翻译仍然完整有效。books.yaml 的实际案例中,旧 parser 只识别出 10 个可本地化语义单元,而当前 parser 识别出 12 个,并新增 PDF 和 GitHub。本文介绍 v2 如何区分 source 变化、普通 stale 和真正的 semantic input expansion,为什么旧 Generation 应保留为历史事实却不能继续冒充当前完整结果,以及为什么重新进入流程前必须证明旧单元全部精确保留、当前输入只是严格扩展。核心结论是:判断翻译能否复用,不能只比较源文件,还必须比较模型真正接收到的正式语义输入。
-
代码块中的注释并不都是不可翻译内容:教学性自然语言通常应该进入翻译,而机器指令、结构和技术语义必须保持不变。更难的问题是,怎样证明所有应该翻译的注释都已经被发现,而不是只检查已经进入流程的那一部分。本文介绍 Go Learning & Documentation v2 如何从规范源内容建立代码注释清单,区分教学注释、机器语义和不支持的未知内容,再与当前正式译文进行精确对应,检查 missing、extra、结构变化和受保护内容变化。核心目标是避免静默遗漏,让“翻译质量正确”和“翻译内容完整”同时成立。
-
Go Learning & Documentation v2 中,一个上游内容发生变化后,并不意味着所有下游状态都应该一起失效。本文介绍 v2 如何通过依赖关系、当前身份和真实影响范围,判断哪些翻译单元、质量审核、内容包封存、整合站点结果和激活状态仍然有效,哪些必须重新进入流程。核心目标不是尽量减少失效,而是让失效传播足够准确,让每一次变化只产生它真正应该产生的工程成本。
-
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 应该如何分工。
