翻訳パイプラインを設計する

責任の所在、レビュー、配信、復旧を明確にし、翻訳元の変更を実際に使える翻訳につなげます。

翻訳パイプラインが完結するのは、翻訳元の変更が、それを必要とするシステムで使えるコンテンツになったときです。翻訳の生成は、その一部にすぎません。ワークフローには、適切なリビジョンの特定、その翻訳結果の取得、受け入れ済みの成果の保持、公開できる内容の判断も求められます。

まずは、リポジトリのカタログ、コンテンツ管理システムの記事、アプリケーションのレコードなど、実際に扱うコンテンツを一種類選び、それを軸に設計します。それぞれ責任者も配信の仕組みも異なります。三つを同じように扱うワークフローでは、結果を安全に使えるかどうかを左右する判断が見えなくなるおそれがあります。

各段階の移行に責任を持つ人を明確にする #

リポジトリのカタログを対象とする場合、たとえば次のように設計できます。

段階の移行決定事項
翻訳元が処理対象になる生成済みの翻訳を対象から除外する信頼できるトリガーを使い、記録されたコミット時点のレビュー済み原文を翻訳する。
作業が始まる明示的に指定したローカライゼーションエンジン、ロケール、形式、受け入れ済みのベースラインを使用し、必要な場合は実行の承認を得る。
翻訳が受け入れ可能になる割り当てられたレビュー担当者が必要な変更を確認し、未解決のケースは見える状態に保つ。
出力が戻るダウンロードと検証を終えたリソースを、翻訳用のプルリクエストに含める。
コンテンツが読者に届くアプリケーションのリリースに変更が取り込まれ、リソースのチェックに合格する。
結果を元に戻す必要が生じる正常と確認できているリソースと、関連する設定またはベースラインを復元する。

これはワークフロー設計の一例であり、製品の既定の動作ではありません。各決定を確実に実施する具体的な仕組みを明記してください。チームの方針を自動で徹底する仕組みがない場合は、その実施を確認する担当者を決める必要があります。

責任範囲に応じてツールを選ぶ #

標準の連携機能は、インストール時に付与された権限で、プロバイダーのトリガーと書き戻しを担えます。CLIランナーはローカルでの取得とコミットを、APIの呼び出し元は保存済みリビジョンの管理と出力の有効化を担います。それぞれの責任範囲に合った、サポート対象の利用仕様を選んでください。

Studioは翻訳の設定と判断を管理し、DevToolsはプログラム経由の実行とファイル処理を提供し、Radarは利用可能な測定結果と調査の根拠を提供します。これらは組み合わせて使う機能であり、決まった順序で導入しなければならないものではありません。

選んだプロバイダーの手動・自動モード、下書きの扱い、利用条件、接続解除の影響を確認してください。コンテンツ管理システムに公開する接続と、リポジトリにプルリクエストを作成する接続とでは、受け入れが確定する段階が異なります。

リビジョン間の対応関係を保つ #

コンテンツの識別情報、翻訳元のリビジョン、翻訳先ロケール、出力のリビジョンまたは成果物、設定、受け入れ状況をひとまとまりで保持します。翻訳やレビューの実行中に新しい翻訳元が届いた場合の扱いも決めてください。最後に完了したというだけで、古い結果が現行版になってはいけません。

再利用によって受け入れ済みの翻訳を保持する箇所と、新たに生成する箇所を決めます。同じ形式に対応していても、API、CLI、アプリで同じオプションが使えるとは限りません。呼び出し元が使う正確なベースラインと、強制実行時の挙動を設計に反映してください。

未解決のケースへの対応を計画する #

入力の拒否、翻訳先での処理失敗、取得の中断、レビュー待ち、ローカルでの競合、応答が不確かな場合について、その後の対応を定義します。次の操作では、定められた仕様に従い、確認できている作業を復旧できるようにしてください。受領記録が失われたからといって、すべてを最初からやり直すべきではありません。

一部の翻訳先が未解決のままでも、完了した翻訳を配信前の状態で待機させられる場合があります。リリースにすべての翻訳が必要なのか、意図的に代替コンテンツを使ってよいのかを決めてください。レビューポリシーでは、判断が下されない場合やタイムアウトした場合の扱いを定めます。あらゆる状況に共通する再試行操作を作るのではなく、作業を担うツールに実行制御を持たせてください。

品質の根拠を解釈できるようにする #

Lingo.dev以外で作成した翻訳も含め、リリースにとって重要な確認事項を定義します。測定は、受け入れ済みコンテンツの管理や公開判断を担わなくても、レビューが必要な作業を特定できます。

測定の設計では、基準、根拠、回答の状態、レポートの対象集団について説明します。その根拠を解釈し、翻訳元の意味が不明確な箇所を解決する担当者も、ワークフローの一部として割り当ててください。

対象を広げる前に一連の流れを検証する #

翻訳元の変更を一つ選び、送信、取得、検証、レビュー、配信、利用までの全工程を実行します。安全に試せる環境で、処理中に翻訳元を変更し、一つの翻訳先で処理の失敗を再現してください。現行のリビジョンを引き続き特定でき、復旧時にも受け入れ済みの出力が保持されることを確認します。

ワークフローの試行を通じて、実際に実行された内容と、まだ検証できていない内容を記録します。別の運用担当者が、翻訳を利用可能にするまでの流れと、以前の利用可能な状態に戻す方法の両方を説明できれば、その設計を広げる準備は整っています。