设计翻译流水线
明确责任归属、审核、交付和恢复机制,将源内容变更转化为可用译文。
只有当源内容变更转化为所需系统中的可用内容时,翻译流水线才算完整。生成只是其中一环。工作流还需要识别正确的修订版本、获取对应的目标译文、保留已接受的成果,并决定哪些内容可以发布。
先围绕一种实际的内容类型展开设计:代码仓库中的翻译资源目录、CMS 文章或应用记录。它们的负责人和交付方式各不相同。如果工作流对三者采用相同的处理方式,就可能掩盖决定结果能否安全使用的关键决策。
明确每次状态转换的负责人 #
针对代码仓库翻译资源目录,可以采用以下设计:
| 状态转换 | 决策 |
|---|---|
| 源内容满足处理条件 | 使用排除已生成目标译文的可信触发机制,翻译已记录提交版本中经过审核的源内容。 |
| 开始处理 | 使用明确指定的本地化引擎、语言区域、格式和已接受的基线;按要求取得运行批准。 |
| 目标译文达到可接受标准 | 由指定的审核者检查所需变更,并确保未解决的情况仍然可见。 |
| 输出回传 | 将下载并验证后的资源纳入翻译拉取请求。 |
| 内容呈现给读者 | 应用发布版本采纳该变更,并通过资源检查。 |
| 结果需要撤销 | 恢复已确认可用的资源,以及相关配置或基线。 |
这只是工作流设计示例,并非产品的默认设置。请明确落实每项决策的具体机制。如果团队政策没有自动控制措施,就需要指定人员负责检查。
按工具的职责选择工具 #
原生集成可以在安装授权范围内负责提供方的触发机制和回写。CLI 执行程序负责本地获取和提交。API 调用方负责其存储的修订版本以及输出的启用。请选择受支持且与这些职责相符的接口约定。
Studio维护翻译配置和决策;DevTools提供编程调用和文件执行能力;Radar提供可用的测量结果和调查依据。这些能力可以组合使用,并不是必须依次采用的步骤。
了解所选提供方的手动和自动模式、草稿处理方式、可用权限,以及断开连接的后果。向 CMS 发布内容的连接,与在代码仓库中创建拉取请求的连接,具有不同的验收边界。
完整保留修订版本之间的关联 #
将内容标识、源内容修订版本、目标语言区域、输出修订版本或产物、配置和验收状态一并保留。明确翻译或审核期间出现更新的源内容时该如何处理。不能仅仅因为旧结果最后完成,就将其作为当前版本。
明确哪些环节通过复用保留已接受的目标译文,哪些环节需要重新生成。支持相同格式,并不意味着 API、CLI 和应用提供完全相同的选项。设计中应保留调用方使用的确切基线和强制执行行为。
规划未解决情况的处理方式 #
明确输入被拒绝、某个目标处理失败、获取中断、等待审核、发生本地冲突或响应不确定时,接下来该如何处理。下一步操作应按照相应约定恢复已知成果,而不是因为回执丢失就全部重来。
当某个目标仍未解决时,其他已完成的目标译文可以先暂存。明确发布是否需要全部目标译文,还是可以主动采用回退方案。审核策略规定缺少决策和超时会带来哪些后果。执行控制应由负责该任务的工具管理,而不是另行设计一个通用的重试操作。
让质量依据易于解读 #
明确对发布至关重要的问题,包括针对在 Lingo.dev 之外生成的译文。测量可以识别需要审核的内容,但不必因此成为管理已接受内容或决定是否发布的系统。
测量设计说明标准、依据、回答状态和报告所涵盖的对象。将人员分工纳入工作流,明确由谁解读这些依据、澄清源内容中不确定的含义。
扩展前,先验证完整周期 #
让一次源内容变更走完提交、获取、验证、审核、交付和使用的全过程。在安全的试运行中,于处理期间修改源内容,并模拟一个目标处理失败。确认当前修订版本仍可识别,且恢复过程能够保留已接受的输出。
通过工作流试运行记录实际执行了哪些环节,以及哪些环节尚未测试。当另一位操作人员能够说明译文如何变得可用,以及如何恢复到之前可用的状态时,这套设计就可以扩展了。