測定対象の翻訳を収集する

対応する収集元を選び、測定に必要なテキスト、リビジョン、コンテキストを保持します。

測定は、チームがすでに作成している翻訳から始められます。承認済みのテキストは引き続きリポジトリや翻訳管理システムで管理し、そのテキストをチェックに利用する方法を選びます。

測定では、バージョンを特定できることが重要です。評価後にメッセージが変更されても、以前の回答が示すのは変更前の文面に対する評価です。原文と訳文のリビジョンをひも付けておけば、最新のコンテンツから根拠を再構成することなく、評価時の根拠に立ち返れます。

ワークフローに合った収集元を選ぶ #

収集元測定方法
CrowdinのアクティビティCrowdinに接続し、イベントに対する測定を設定して、生成されたRadarのイベントと回答を確認します。Radarの画面を利用するには、Radarへのアクセスが必要です。
GitHubのコミットGitHub Appに接続し、原文と訳文のパスを設定します。既定のブランチで、対応しているローカライゼーションキーに変更があると、イベントが生成されます。
ZendeskヘルプセンターZendeskに接続します。公開済み記事への変更は、各言語の原文イベントまたは翻訳イベントとして記録されます。
ローカルの翻訳ファイル採点ツールとモデルを設定し、lingo scoreを使用します。結果はローカルに保存され、Radarのイベント履歴には記録されません。
Lingo.devの翻訳完了したローカライゼーションは、すでにそれぞれイベントとして記録されています。エンジン、言語、サンプルの選び方は、Lingo.devの翻訳をレビューするで説明しています。

それ以外の収集元については、配信を自動化する前にLingo.devに問い合わせ、イベント収集の準備を整えてください。

GitHubとZendeskのアクティビティを収集する #

GitHubでは、対象のリポジトリにアプリをインストールし、Lingo.devの組織に接続します。ソースロケール、ターゲットロケール、ソースファイルのパターンを指定した.lingo/config.jsonをコミットします。これらのパスを使って、原文への変更と翻訳への変更を識別します。既定のブランチへのコミットで、設定したローカライゼーションキーが変更されたら、イベントを確認してください。1つのコミットから、複数のキーや言語のイベントが生成されることがあります。

GitHubからの収集では、JSON、JSONC、YAML、ルートキー付きのYAML、Androidリソース、Appleの.strings、FlutterのARB、PHP、TypeScriptのファイルを読み取ります。変更がイベントになる仕組みは、リポジトリの変更で説明しています。

Zendeskでは、ヘルプセンターへの接続を承認し、使用する言語を有効にします。Radarは、公開済み記事のアクティビティを言語別に記録します。イベントを開き、記事の識別情報、ロケール、テキストをZendeskと照合してください。アクティビティを収集するだけでは、翻訳の同期や新しい翻訳記事の公開は行われません。

どちらの接続でも、承認済みの翻訳は元のシステムに保持されます。測定は記録されたイベントを検証するものであり、公開処理を担うものではありません。

測定前にプロバイダーの履歴をインポートする #

必要なプロバイダーの履歴を選びます。

  • GitHub:リポジトリの既定のブランチから、最新のコミットを最大5,000件インポートします。各コミットは、そのリビジョンに保存されている.lingo/config.jsonを使って読み取られます。この設定が存在する前のコミットからは、イベントは生成されません。
  • Zendesk:各言語の既存の記事、セクション、カテゴリについて、現在公開されているバージョンを最終更新日時とともにインポートします。以前のリビジョンや下書き版は収集の対象外です。

GitHubとZendeskに新しく接続すると、履歴のインポートが自動的に始まります。接続の設定タブで進捗を確認できます。後からインポートを開始または再試行するには、次の手順に従ってください。

  1. スタジオの接続済みでリポジトリまたはヘルプセンターを選び、設定タブを開きます。
  2. GitHubの場合はコミット履歴、Zendeskの場合はヘルプセンターの履歴で、履歴をインポートを選びます。
  3. インポートの進捗を確認します。収集待ちのキューに登録されたプロバイダーの項目数が表示されます。
  4. 測定対象のイベントがRadar → ログに表示されるまで待ち、日時、ロケール、テキストを確認します。

プロバイダーのイベントを対象とする測定では、バックフィルタブのイベントをインポートからも、接続済みのGitHubリポジトリとZendeskヘルプセンターを選べます。履歴のインポートでは収集のみが行われ、測定は実行されません。必要なイベントが表示されたら、測定を有効にし、その期間を対象に過去のイベントの評価を開始してください。

バックフィル後に、インポートされたイベントがさらに表示された場合は、未測定のイベントのみを有効にしてバックフィルを再実行します。インポートに失敗した場合は、進捗を確認し、同じ設定タブから再試行してください。測定のバックフィルと結果は、インポートとは別に確認します。

比較対象を保持する #

収集元システムの識別子、コンテンツの識別子、ターゲットロケール、訳文のリビジョンをひも付けて保持します。意味のチェックでは、対応する原文のリビジョンも追加します。編集の測定では、編集後の訳文の元になった下書きを保持します。

たとえば、チームの追跡記録では、delivery.promise、ロケールfr、リビジョン42の組み合わせで、特定のカタログ項目を識別できます。リビジョン43では、約束している内容が変わる可能性があります。

ワークフローから作成元の情報が得られる場合は、人、モデル、機械翻訳プロバイダー、翻訳メモリの再利用のいずれかを記録します。出所が不明な場合は、不明のまま保持してください。プロバイダー側で翻訳を承認したユーザーが、その翻訳を作成した人やモデルとは限りません。

選んだ問いに必要な根拠を用意する #

何を収集するかは、評価基準によって決まります。スペルのチェックは訳文だけで行えます。意味のチェックには、対応する原文と訳文に加え、曖昧さを解消するためのコンテキストが必要です。用語のチェックには、適用する用語とその使用範囲が必要です。プレースホルダーのチェックには、想定されるプレースホルダーの仕様が必要です。編集距離の測定には、実際の下書きと訳文の組み合わせが必要です。

翻訳に対応する原文のリビジョンがない場合は、意味のチェックでは未評価のまま保持し、判定する前に原文を入手してください。

収集したイベントを1件確認する #

  1. 接続済みの収集元でテスト用のアクティビティを発生させる前に、選んだ測定を設定します。
  2. 対応するイベントを見つけます。ロケール、テキスト、出所、利用可能な下書きを、チームの記録と照合します。
  3. 測定の回答を開き、テキストと並べて評価基準を確認します。回答が返されたか、該当なしとされたか、処理が完了しなかったかを確認してください。
  4. イベントと測定の識別情報を、評価したリビジョンにひも付けて保持します。採用する修正は、そのテキストを管理するシステムで行います。

ローカルで採点する場合は、代わりに、保存された結果を入力ファイルや採点ツールの設定と照らし合わせて確認します。この方法では、Radarのイベントは作成されません。

ワークフローを繰り返し実行する場合は、何を選び、収集し、測定したかを記録しておきます。パイプラインから翻訳を測定するでは、再試行やリビジョンの変更への対応を含め、収集と復旧の方法を説明しています。