规划多语言发布

将面向每类受众的内容与其源内容版本、交付检查、质量佐证和发布决策关联起来。

多语言发布为不同受众提供同一内容的可用版本,传达一致的原意。完成翻译只是备齐了文本;要真正达到可发布状态,还需要正确的资源、可用的路由、相关审核和发布授权。

以每类受众实际会收到的内容为出发点来规划。这样,即使大多数翻译任务已经完成,仍能发现缺失的语言区域或尚未确认的表述。

明确发布范围 #

列出必需的语言区域和面向读者的内容:应用消息、文档、电子邮件、元数据,以及纳入范围的其他内容载体。记录源内容版本和计划时间。将必需的覆盖范围与可选的新增内容分开,避免未完成的工作被笼统的多语言状态掩盖。

使用稳定的标识,不要只看文件数量。十个文件中可能有重复文件,却缺少一条重要消息。将消息目录与界面或流程关联,将文档与路由、路径别名及其他语言版本的对应关系关联。

为每项内容记录三项信息:翻译佐证、交付佐证和待定事项。电子邮件即使已通过审核,仍需渲染主题、正文和链接。帮助页面即使已获取译文,仍需确保路由可用,并由内容负责人验收。将这些记录保存在团队现有的发布工作系统中。

保留供审核者核对的源文与译文配对 #

记录提交审核的源内容版本和目标内容版本。源内容发生变化时,应确定哪些佐证受到影响,而不是一律将所有目标内容视为过时。修正拼写与变更退款条件,带来的影响并不相同。

保留先前的源内容、已验收的目标内容和工作流状态,以实现增量保留。先解决本地冲突,再获取替换输出,而不是强制重新生成每个语言区域的内容。

明确提交、执行批准、译文验收和发布各环节的触发条件与授权安排。同一个人可以担任多个角色,但各角色的权限仍有区别。

按读者实际使用的形式测试交付 #

对于应用消息目录,在真实运行环境中加载目标内容,测试变量和复数形式,并检查重要界面。对于文档,打开实际路由,逐一访问链接,并验证组件和片段。对于电子邮件,使用安全的测试数据渲染主题、预览文本、HTML 和纯文本。

检查显式语言选择、语言协商和回退机制。回退能让界面保持可用,却也可能掩盖必需译文的缺失。记录哪些地方允许回退,并直接测试所要求的目标内容。

根据内容格式选择合适的检查方式。JSON 解析、Android 构建、Rails 查找和 Markdoc 验证分别验证不同的特性。将各项检查的佐证与其覆盖的发布内容一同保存。

先明确验收标准,再汇总质量 #

列出可能阻止发布的要求:含义、受保护的术语、变量、无障碍支持、路由可用性或品牌语调。针对每项要求,选择由合格人员进行的审核或适用的测量方法。评分能为某项标准提供佐证,但不代表获得了发布许可。

记录尚未确认的佐证。测量设计说明了回答状态和分母的定义,避免总体结果掩盖覆盖不足或尚无已完成回答的语言。

明确部分就绪时的发布方式 #

决定某个语言区域尚未完成时,是阻止整个发布、暂缓发布该语言区域,还是使用已明确认可的回退方案。同时考虑依赖关系:帮助文章通常可以单独发布,而尚未确认的价格条件可能阻止某个语言区域的交易流程发布。

在实际执行部署或发布的系统中,指定发布负责人和回滚方法。保留最近一次验收通过的产物,并明确如何在不重新翻译的情况下恢复它。不要假定所有翻译工具都有通用的发布操作。

作出最终决策时,将发布范围与实际产物逐一对照:哪些内容将上线、包含哪些版本、哪些内容仍暂缓发布,以及由谁批准。就绪意味着这些事实相互一致,而不只是翻译队列恰好为空。