Jiraで翻訳の問題をトリアージ
ラベル付きのJiraフィードバックをエンジンへの変更提案につなげ、変更ごとにレビューし、再翻訳する連携済みコンテンツを選択します。
翻訳の問題として報告されるのは、製品用語の誤り、翻訳済みの画面に残る英語のボタン、表示領域に収まらなくなったテキストなど、目に見える症状であることがよくあります。Jiraを接続すると、こうしたフィードバックをキューに取り込み、選択したエンジンの用語集、ルール、ブランドボイスへの変更提案をレビューできます。
Studio 2.5のナビゲーションでは、設定 → 連携ではなくStudio 2.5 → 連携を開いてください。既存の接続用リンクや設定用リンクは引き続きご利用いただけます。
提案ごとに適用または却下を選択します。変更を適用したら、チケットの再翻訳タブで、再生成する連携済みコンテンツを選びます。
Jiraを接続して問題を記述する #
この連携は、Jira Service Management Cloudを含むJira Cloudに対応しています。利用にはEnterpriseプランが必要です。現在の提供状況は、料金をご覧ください。
- 対象のLingo.dev組織でキュー → 設定を開きます。
- トリアージの取り込み元で接続を選択し、AtlassianのOAuth認証でJiraサイトへのアクセスを許可します。アカウントの接続は設定 → 連携で管理します。
- キューの設定に戻り、対象サイトのエンジンを選択を選びます。そのサイトの課題に基づく変更を許可するローカライゼーションエンジンを選び、保存を選択します。
サイトの課題から提案を生成するには、エンジンを少なくとも一つ選択する必要があります。選択内容を保存すると、lingoラベルが付いた既存の未解決の課題も取り込まれます。一つのサイトを同時に接続できる組織は一つだけです。Jiraのコメントは、アクセスを許可したアカウント名義で投稿されます。チーム共通の投稿者名義が必要な場合は、適切な共有アカウントを使用してください。
サイトの接続、エンジンの選択、再翻訳にはorg:manage_integrationsが必要です。提案の適用または却下には、org:suggestion:editと対象エンジンの編集権限が必要です。または、組織メンバーとして対象エンジンへの権限が明示的に付与されている必要があります。権限の付与方法は、提案の権限をご覧ください。
調査に必要な情報を課題に記載してください。
- 影響を受けるロケール、正確な原文と実際に表示されている訳文、その場所またはリビジョン。
- 期待する結果と実際に確認された問題。表示上の問題には、スクリーンショットや表示領域の制約も添えてください。
- 関連するアプリケーションまたはローカライゼーションエンジンと、承認済みの用語の取り決め。
たとえば、「es-MXのチェックアウトで、原文が『注文を確定』を意味するボタンが、リビジョンXでは英語のまま表示されています」のように記載します。この報告では、用語集の項目を修正すれば解決するとは決めつけずに、未翻訳の箇所を特定しています。
未解決の課題にラベルlingoを追加します。大文字と小文字は区別されません。Lingo.devが課題の要約、説明、コメントを読み取り、サイトで選択されているエンジンへの変更を提案します。キューを開き、種類フィルターでトリアージ項目を表示して、チケットを選択し、提案をレビューします。
ラベル付きの課題を更新した場合も、キューに取り込まれることがあります。すでに開いているチケットでは、現在の一連の提案が維持されます。
提案された修正が問題に合っているか確認する #
提案を適用する前に、報告された問題の発生箇所を確認してください。共通の翻訳指針が必要な問題もあれば、アプリケーションや配信方法の変更が必要な問題もあります。
| 報告された問題 | 確認すること |
|---|---|
| ある言語で製品用語が誤っている | 本来使うべき用語、ロケールの組み合わせ、用語集の変更が必要なローカライゼーションエンジン。 |
| 韓国語の日付形式が想定と異なる | その値が翻訳されたテキストなのか、アプリケーションの書式設定処理で生成されているのか。 |
| ドイツ語のテキストがナビゲーションの操作部品からはみ出す | 意味を保った簡潔な表現で表示幅に収められるのか、コンポーネントのレイアウト変更が必要なのか。 |
| 複数の言語で原文が表示される | 各ロケールの翻訳が生成され、読み込まれ、選択されているか。 |
| API通信で429が返される | APIの制限ではなく、そもそも翻訳の表現に関する問題なのか。 |
カタログの欠落、日付の書式設定処理、レイアウトの不具合は、アプリケーションの担当者に修正を割り当ててください。用語集、ルール、ブランドボイスの変更は、報告された表現上の要件に対応できる場合に使用します。
各提案を適用または却下する #
チケットの提案タブを開きます。提案ごとに、ローカライゼーションエンジン、言語、説明、変更先のリソースを確認します。提案される変更には、次のものがあります。
- 用語集の用語を追加または更新する。
- 翻訳ルールを追加または更新する。
- ブランドボイスのバリエーションを追加または更新する。
適用を選択すると、その変更がすぐに保存されます。却下を選択すると、指針は変更されません。指針に重複や矛盾がないか、変更先のリソースを共有する他のエンジンも含めて確認してください。適用後は、保存された用語、ルール、ブランドボイスのバリエーションを開いて内容を確認します。
生成が完了し、チケットの各提案を適用するか却下するかが決まると、Lingo.devが結果の要約とキューへのリンクをJiraのコメントに投稿します。どのエンジンからも変更が提案されなかった場合は、その旨が要約に記載されます。結果を確認したら、チームの通常の手順でJiraの課題をクローズしてください。
既存の翻訳を更新するか決める #
提案を適用したら、チケットの再翻訳タブを開きます。影響を受けるGitHub、Zendesk、Payloadのコンテンツ管理システムとの連携と、変更の対象となる翻訳先ロケールが表示されます。
更新する連携を選択し、一覧のロケールを確認して、再翻訳を選択します。選択した各連携で設定されている範囲全体が、対象ロケールで再生成されます。承認済みの手動編集が上書きされる可能性があり、通常どおり翻訳使用量に計上されます。
各実行の進行状況を確認し、出力先で結果を点検します。GitHubではリポジトリの差分またはプルリクエストを、ZendeskやPayloadでは翻訳済みコンテンツと公開状態を確認してください。通常の手順でレビューし、マージまたは公開します。再翻訳は後回しにしてもかまいません。適用済みの指針は保存されたままです。
トリアージを復旧または終了する #
lingoラベルを外すか、イシューをクローズまたは削除すると、対応するキューのチケットがクローズされ、他の未完了のチケットから参照されていない保留中の提案が破棄されます。適用済みの変更はそのまま保存されます。ラベルが付いた状態でイシューを再開するか、チケットのクローズ後に未完了のイシューにラベルを付け直すと、それまでの履歴を保持したまま、新たな提案が始まります。
表示されるはずのチケットが見つからない場合は、課題が未解決で、lingoが付いており、キュー → 設定でエンジンを選択した接続済みサイトに属していることを確認してください。組織のプランと接続状態も確認します。接続先へのアクセスが復旧してもチケットが処理中のままの場合は、そのリンクをLingo.devのサポートに共有してください。
アカウントの認可と切断は、設定 → 連携で管理します。接続を維持したまま新しい課題からの提案生成を止めるには、キュー → 設定で対象のエンジン選択をすべて解除して保存してください。既存のチケットは、別途Jiraで終了します。
Jiraのウェブフックは定期的に更新されます。更新が届かなくなった場合は、サイトの認可と接続状態を確認し、アクセスの復旧が必要なときは再接続してください。プロバイダーへのアクセスを終了する場合は、OAuthの認可を別途取り消します。既存のコメント、適用済みの指針、生成済みの翻訳結果は残ります。