ローカリゼーションエンジニアリング

GitLab のローカリゼーションインフラとエンジニアリングプロセスの技術的詳細。

ドキュメントとプロダクトインターフェースをまたぐ、GitLab のローカリゼーションインフラおよびエンジニアリングプロセスの技術的概要です。翻訳環境、ブランチ管理、開発ワークフロー、国際化されたコンテンツのプレビューシステムを含みます。

ローカリゼーション技術スタックの全体像については、GitLab におけるローカリゼーション技術管理 を参照してください。プロダクトドキュメントのローカリゼーションアーキテクチャおよびワークフローについては、GitLab プロダクトドキュメントのローカリゼーション を参照してください。

チーム

コミュニケーションチャネル

  • #localization-engineering: ローカリゼーションエンジニアリングチームの作業チャネル
  • #localization-alerts: フォーク同期パイプラインの自動失敗レポートおよび Translation MR 通知
  • #spartan-software: Spartan Software エンジニアリングチームとの直接のコミュニケーション
  • #argos_multilingual: Argos Multilingual エンジニアリングチームとの直接のコミュニケーション

ローカリゼーション関連の Slack チャネルの完全なリストについては、Localization handbook を参照してください。

範囲

ローカリゼーションエンジニアリングチームは、GitLab のコンテンツとプロダクトを複数の言語で配信できるようにするインフラストラクチャを所有・保守しています。

サポートしているコンテンツストリーム:

  • GDATP / GitLab Translation Agent: Duo Agent Platform 上に構築された GitLab ネイティブの AI 翻訳プラットフォームです。アドホックかつインパクトの大きいマーケティングコンテンツ(料金ページ、ランディングページ、ブログ、複数言語同時のコーディネートされたローンチなど)の翻訳に使用されます。Content Manager、Program Manager、Engineer がセルフサービス型の翻訳ツールとして GDATP を使用します。エンジニアリングチームはプラットフォーム、システムプロンプトのアーキテクチャ、言語仕様、ワークフロー開発を所有しています。
  • プロダクトドキュメント (docs.gitlab.com): 国際化レイヤーと、Argo オーケストレーションプラットフォーム、Phrase TMS、AI 駆動の翻訳といった連携ツールを備えたローカリゼーションアーキテクチャ。エンジニアリングチームはフォーク同期の自動化、Translation MR の作成、アップストリームへのプッシュプロセスとその自動化、Hugo の国際化設定、継続的ローカリゼーションパイプラインの開発を所有しています。アーキテクチャの詳細については、GitLab プロダクトドキュメントのローカリゼーション を参照してください。
  • マーケティングウェブサイト (about.gitlab.com): 新規ページや注目度の高いコンテンツについては GDATP、ボリュームの大きい更新や非同期更新については Argo-Phrase パイプラインを通じて、6 言語にわたる継続的ローカリゼーションを実施しています。
  • プロダクト UI: Crowdin によるコミュニティ主導の翻訳。GitLab String Search ツールおよび Crowdin Automation スクリプトでサポートされています。

イテレーションプロセス

イテレーションは火曜日に開始します。イテレーション期間中にリリースを行います。イテレーション期間は 2 週間です。ローカリゼーションエンジニアリングのイテレーション を参照してください。

エンジニアリング作業の追跡には 2 つのボードを使用します:

  • 担当者別: ~"L10n-engineering" ラベルが付いたすべての作業項目をチームメンバーごとにグループ化して表示
  • ステータス別: Refinement -> Ready for development -> In dev -> In review -> Complete のワークフロー進捗を表示

レビューワークフロー

ローカリゼーションエンジニアリングチームによるマージリクエストレビュープロセスは、GitLab の コードレビューガイドライン に沿って行われます。

ローカリゼーションエンジニアリングチームは、お互いのマージリクエストおよび Translation MR をレビューします。Translation MR は、マーケティングウェブサイトおよび GitLab プロダクトドキュメントについて Argo で翻訳が完了したときに @gitlab-argo-bot によって作成されます。

ローカリゼーションエンジニアリングは、複数言語で Blog を所有・保守しているローカリゼーション Content Manager が Decap CMS で作成した MR のレビューを支援します。Decap からのブログ更新 MR は通常、デプロイの俊敏性に資するコンテンツのみの変更であり、軽量なレビュープロセスで対応できます。Content Manager は、複雑な変更、コード、トラブルシューティングが必要な場合は、ローカリゼーションエンジニアまたは Digital Experience (DEX) エンジニアにレビューを依頼することがあります。

ベンダーエンジニアリングパートナーシップ

  • Spartan Software - Argo オーケストレーションプラットフォームの開発と保守
  • Argos Multilingual - AI 翻訳パイプラインおよびプロジェクト、言語サービス、翻訳管理システムの設定、Crowdin エンジニアリング