多言語リリースを計画する
各利用者層に届けるコンテンツを、原文のリビジョン、配信の検証、品質の根拠、公開判断に結び付けます。
多言語リリースでは、同じ制作物を、その意図を保ちながら、それぞれの利用者層が使える形で届けます。翻訳が完了すればテキストはそろいますが、リリースの準備を整えるには、適切なリソース、正常に機能するルート、必要なレビュー、公開権限も欠かせません。
それぞれの利用者層に何を届けるかを軸に計画しましょう。そうすることで、ほとんどの翻訳ジョブが完了していても、未対応のロケールや、記述内容に未解決の問題がある箇所を把握できます。
リリース対象を定義する #
必須のロケールと、利用者が目にするコンテンツを一覧にします。アプリのメッセージ、ドキュメント、メール、メタデータなど、対象となるすべての表示箇所を含めてください。原文のリビジョンと予定時期も記録します。必須の対応範囲と任意の追加分を分け、多言語対応全体の進捗に未完了の作業が埋もれないようにします。
ファイル数だけに頼らず、各項目を継続して識別できる情報を使います。ファイルが十個あっても、重複がある一方で、重要なメッセージが抜けているかもしれません。カタログは画面や操作フローに、ドキュメントはルート、スラッグ、他言語版との対応関係に結び付けます。
各項目について、翻訳の確認記録、配信の検証記録、残っている判断の三つを記録します。レビュー済みのメールでも、件名、本文、リンクの表示確認は必要です。ヘルプページの翻訳を取得できていても、ルートの動作確認とコンテンツ責任者による受け入れは別途必要です。これらの記録は、チームが普段リリース作業に使っているシステムで管理します。
レビュー対象の原文と訳文の組み合わせを保持する #
レビューに提出した原文と訳文のリビジョンを記録します。原文が変わったら、すべての訳文を一律に古いものと見なすのではなく、どの確認記録に影響するかを特定します。綴りの修正と返金条件の変更では、影響が異なります。
差分更新時の保持のために、変更前の原文、受け入れ済みの訳文、ワークフローの状態を残します。すべてのロケールを強制的に再生成するのではなく、置き換え用の出力を取得する前にローカルの競合を解消します。
提出、実行承認、翻訳の受け入れ、公開について、それぞれの開始条件と権限を定めます。一人が複数のロールを担うことはできますが、それぞれの権限は別のものです。
利用者が実際に使う形で配信をテストする #
アプリのカタログは、実際の実行環境で訳文を読み込み、変数や複数形の動作を試して、重要な画面を確認します。ドキュメントは、実際のルートを開いてリンクをたどり、コンポーネントやフラグメントを検証します。メールは、安全なテストデータを使って、件名、プリヘッダー、HTML、プレーンテキストを表示し、確認します。
明示的な言語選択、言語ネゴシエーション、フォールバックを確認します。フォールバックは画面を使える状態に保つ一方で、必須の翻訳の欠落を隠してしまうことがあります。使用を許可する箇所を記録し、必須の翻訳先言語を直接指定してテストします。
形式に合った検証を行います。JSONの解析、Androidのビルド、Railsのルックアップ、Markdocの検証では、それぞれ確認できる性質が異なります。各検証の記録は、対象となるリリース項目とともに管理します。
品質を総括する前に受け入れ基準を定める #
意味、厳守すべき用語、変数、アクセシビリティ、ルートの利用可否、語り口など、満たされなければ公開を止める要件を明示します。要件ごとに、適任者によるレビューか、適用可能な測定方法を選びます。スコアは基準を満たすかどうかの判断材料であり、リリースを許可するものではありません。
確認が済んでいない根拠も記録します。測定の設計では、回答の状態と分母について説明しています。全体の結果に、確認範囲が狭い言語や回答が一件も完了していない言語が埋もれないようにするためです。
一部だけ準備が整った場合の対応を決める #
未完了のロケールがある場合に、リリース全体を止めるのか、そのロケールの公開を見送るのか、明示的に受け入れられたフォールバックを使うのかを決めます。依存関係も考慮しましょう。ヘルプ記事は単独で公開できることが多い一方、料金条件に未解決の問題があると、そのロケールの取引フローを公開できない場合があります。
実際にデプロイや公開を行うシステムで、公開責任者とロールバック方法を定めます。最後に受け入れられた成果物を保持し、再翻訳せずに復元する方法を把握しておきます。翻訳ツールに共通の公開操作があることは前提にしません。
最終判断では、リリース対象と実際の成果物を照合します。何を公開するのか、どのリビジョンが含まれるのか、何の公開を見送るのか、誰が承認したのかを確認してください。準備が整っているとは、これらの事実が一致していることです。たまたま翻訳キューが空になっていることではありません。