Jira 翻译问题分诊

将带标签的 Jira 反馈转化为引擎建议,逐项审核变更,并选择要重新翻译的已连接内容。

翻译问题往往表现为直观可见的现象:产品术语用错、已翻译的界面中仍有英文按钮,或文字超出可用空间。连接 Jira,将这些反馈汇入队列,即可审核针对所选引擎提出的术语表、规则和品牌语调变更建议。

在 Studio 2.5 导航中,请前往 Studio 2.5 → 集成,而非 设置 → 集成。现有的连接和配置链接仍可正常使用。

为每条建议选择应用或忽略。应用变更后,在工单的重新翻译选项卡中决定要重新生成哪些已连接内容。

连接 Jira 并描述问题 #

此集成支持 Jira Cloud,包括 Jira Service Management Cloud,需要 Enterprise 套餐才能使用。有关当前可用情况,请参阅定价。

  1. 在目标 Lingo.dev 组织中打开队列 → 设置。
  2. 在分诊来源下选择连接,通过 Atlassian OAuth 授权 Jira 站点。账户连接可在设置 → 集成中管理。
  3. 返回队列设置,点击该站点的选择引擎。选定允许该站点的问题触发变更的本地化引擎,然后选择保存。

站点必须至少选定一个引擎,其问题才会生成建议。保存选择时,系统也会处理已有的、带 lingo 标签的未关闭问题。同一站点一次只能连接到一个组织。Jira 评论会以授权账户的身份发布;如果团队需要统一署名,请使用合适的共享账户。

连接站点、选择引擎和重新翻译都需要 org:manage_integrations。应用或忽略建议需要同时具备 org:suggestion:edit 和该引擎的编辑权限,或者作为组织成员获得该引擎的明确授权。建议权限介绍了如何授予访问权限。

请在问题中提供足够的信息,方便排查:

  • 受影响的语言区域、准确的源文本和实际显示的目标文本,以及它们的位置或修订版本。
  • 预期结果和实际问题。如果涉及显示效果,请附上截图或说明空间限制。
  • 涉及的应用程序或本地化引擎,以及任何已获批准的术语决策。

例如:“在 es-MX 的 checkout 中,按钮的源文本为‘Place order’,但在修订版本 X 中,实际显示的目标文本仍为英文。”这份报告指出了具体的未翻译内容,并未预先认定需要通过术语表条目来修复。

为未关闭的问题添加标签 lingo,标签不区分大小写。Lingo.dev 会读取问题的摘要、描述和评论,并为该站点选定的引擎提出变更建议。打开队列,使用类型筛选器显示分诊项目,然后选择工单以审核其建议。

更新带标签的问题也可能将其带入队列。尚未关闭的工单会保留当前这一轮建议。

确认修复建议与问题相符 #

应用建议前,请先阅读报告中的具体问题。有些问题需要统一的翻译指导,另一些则需要调整应用程序或交付方式。

报告的问题需要确认的事项
某种语言中的产品术语不正确应使用的术语、源与目标语言区域对,以及需要修改术语表的本地化引擎。
韩语日期格式不符合预期该值是翻译文本,还是由应用程序的格式化程序生成。
德语文本超出导航控件边界能否用简洁措辞在可用宽度内保留原意,还是需要调整组件布局。
多种语言显示源文本是否已为每个语言区域生成、加载并选用译文。
API 请求返回 429问题是否确实涉及翻译措辞,而非 API 限制。

如果问题是缺少翻译目录、日期格式化程序异常或布局缺陷,请交由应用程序负责人修复。当术语表、规则或品牌语调变更能够满足报告中的措辞要求时,再采用这些变更。

应用或忽略每条建议 #

打开工单的建议选项卡。逐项查看建议涉及的本地化引擎、语言、说明和目标资源。建议可以:

  • 添加或更新术语表中的术语。
  • 添加或更新翻译规则。
  • 添加或更新品牌语调变体。

选择应用可立即保存变更,选择忽略则保留现有指导。请检查指导是否重复或冲突,并查看共享同一目标资源的其他引擎。应用后,打开已保存的术语、规则或品牌语调变体,确认内容无误。

生成完成且工单中的所有建议均已处理后,Lingo.dev 会发布一条 Jira 评论,汇总处理结果并附上队列链接。如果没有引擎提出变更,汇总中也会注明。检查结果后,按团队的常规流程关闭 Jira 问题。

决定是否更新现有译文 #

应用建议后,打开工单的重新翻译选项卡,其中会列出受影响的 GitHub、Zendesk 和 Payload CMS 集成,以及变更涉及的目标语言区域。

选择要更新的集成,核对列出的语言区域,然后选择重新翻译。系统会针对这些语言区域,重新生成每个所选集成已配置范围内的全部内容。此操作可能覆盖已接受的人工修改,并产生正常的翻译用量。

跟踪每次运行,并在相应目标位置检查结果:在 GitHub 中查看仓库差异或拉取请求,在 Zendesk 或 Payload 中查看译文和发布状态。按常规流程审核,再合并或发布。也可以稍后再重新翻译;已应用的指导仍会保留。

恢复或结束分诊 #

移除 lingo 标签、关闭或删除议题,都会关闭对应的队列工单,并清除未被其他开放工单引用的待处理建议。已应用的更改仍会保留。重新打开仍带有该标签的议题,或在工单关闭后为仍处于开放状态的议题重新添加该标签,都会启动新一轮建议,并保留此前的历史记录。

如果预期的工单未出现,请检查问题是否尚未关闭、是否带有 lingo 标签,以及所属站点是否已连接并在队列 → 设置中选定了引擎。同时检查组织的套餐和连接状态。如果恢复连接访问后,工单仍处于处理中,请将工单链接发送给 Lingo.dev 支持团队。

在设置 → 集成中管理账户授权和断开连接。若要保留连接,但不再为新问题生成建议,请在队列 → 设置中清空该站点的引擎选择并保存。现有工单需在 Jira 中单独结束。

Jira 网络钩子会定期续订。如果不再收到更新,请检查站点授权和连接状态;需要恢复访问时,请重新连接。若要终止对提供方的访问,请另行撤销 OAuth 授权。现有评论、已应用的指导和已完成的翻译结果都会保留。