ローカライゼーションエンジンの提案をレビューする
フィードバックが再利用できる指針の根拠になるかを判断し、提案された変更を適用して、新たな翻訳でその効果を確かめます。
修正をきっかけに、今後の翻訳に必要な知識が見つかることがあります。一方で、その一文にしか当てはまらない修正もあります。提案機能は、フィードバック、Jiraチケット、低スコアの翻訳、人による編集をもとに、再利用できる用語集、ルール、ブランドボイスの変更を提案します。チームは、そこから得た学びのうち、どれを今後のリクエストに反映するかを判断できます。
提案を適用すると、今後の翻訳リクエストで使う指針が保存されます。以下の手順で、新たな翻訳結果に対する変更の効果を確かめてください。
提案された変更とその根拠を確認する #
キューで提案を開きます。操作は六種類で、用語集の用語、ルール、ブランドボイスのバリエーションをそれぞれ追加または更新します。提案された内容、説明、対象ロケールの範囲、対象リソース、提案のもとになった根拠を確認します。更新の場合は、現在の内容と置き換え後の内容を比較します。
引用された修正を読み、提案された変更と対象ロケールの範囲を裏付けているかを確認します。限定的な用語の問題であれば、用語を変更する根拠にはなっても、ブランドボイスを広範囲に変更する根拠にはならない場合があります。
対象リソースに関連付けられたローカライゼーションエンジンを確認します。あるローカライゼーションエンジンに表示された提案でも、複数のエンジンで共有する指針を変更する場合があります。修正後の翻訳を受け入れることと、より広い範囲に及ぶ変更を承認することは、別々に判断する必要があります。
提案を適用または却下する #
保留中の提案が有用であれば適用を選択し、保存された用語、ルール、ブランドボイスのバリエーションを開いて変更を確認します。
関連性がない、重複している、範囲が広すぎる、または根拠が不十分な提案は、却下を選択します。適用または却下には、org:suggestion:editとエンジンの編集権限が必要です。または、組織のメンバーとして、そのエンジンへの権限が明示的に付与されている必要があります。どちらのアクセス方法についても、提案の権限で説明しています。
対象が削除されている場合や書き込みに失敗した場合は、エラーと現在の提案の状態を確認します。変更処理に失敗すると、問題を修正できるよう、提案が保留のまま残ることがあります。適用済みの提案を、新たな処理として再び適用することはできません。
一括操作では、成功した項目の識別子を記録し、拒否された項目や未送信の項目を一つずつ確認します。原因を解消してから、未解決の項目だけを再試行します。一括処理を停止しても、保存済みの変更は元に戻りません。
再利用できる変更が役立ったかを確認する #
- 提案のもとになったのが、人による保留中のレビューである場合は、レビューでその翻訳への対応を完了します。低スコアや明示的なフィードバックからは、完了すべきレビューがなくても提案が生成されることがあります。
- 生成された候補、根拠、対象ロケールの範囲、共有の対象リソースを確認します。根拠なく一般化されている場合は、適用範囲を狭めるか、提案を却下します。
- 有用な提案を適用し、保存されたリソースの場所を確認します。
- 同じ代表的な原文とロケールで、新たな翻訳を明示的にリクエストします。そうしないと、内容が変わっていないために以前の翻訳結果が再利用される可能性があります。
- リクエストの根拠情報で新しい翻訳と文脈を比較し、必要に応じて定義済みの測定を使います。
一つの事例で改善が見られても、裏付けられるのはその事例についてだけです。繰り返し改善が得られることを確かめるには、より幅広い事例を選び、成功だけでなく誤りも調べます。このワークフローで変わるのは指針であり、修正内容を使ってモデルを学習させるわけではありません。
生成と適用の方針 #
ローカライゼーションエンジンのレビュアータブを開きます。提案で改善を提案を有効にし、言語を選択します。すべての言語を対象にする場合は、何も選択しないでください。自動生成を無効にする場合も、同じスイッチを使います。
自動生成では、レビュー対象の提案がキューに作成されます。低スコアの根拠情報はまとめて処理され、短時間に連続して発生した場合は処理を遅らせて集約します。また、設定された対象ロケールの範囲によって、生成対象が制限されます。
手動で生成するには、エンジン提案APIを使い、最近の作業や文章で記述したフィードバックをもとに提案をリクエストします。指定したフィードバックは、最近の履歴より優先されます。リクエストしても提案が生成されない場合があります。
生成された提案は、保留状態になります。提案された変更を保存するには適用、見送るには却下を選択します。生成しただけでは、共有の指針は変わりません。Jiraチケットがクローズされると、そのチケットの保留中の提案は、ほかの未完了のチケットから引き続き参照されていない限り却下されます。
自動生成を無効にすると、低スコアや人による編集をもとにした新たな提案は作成されなくなります。ただし、すでに進行中の生成は完了する場合があるため、後で保留中の提案を確認してください。それまでに保存された指針の変更は残ります。設定についてはローカライゼーションエンジンで、提案を適用する際の判断についてはどの修正をルールにするかを決めるで詳しく説明しています。
APIリファレンスでは、ページ分割を使った提案の一覧取得や、サーバー側のワークフローから提案を適用または却下する方法も説明しています。