こんにちは。世界を舞台に開発現場を渡り歩いてきたコーチとして、今日は「グローバルチームにおけるConfluenceの運用」という、多くのエンジニアが躓き、そして多くのチームが泥沼化する難所についてお話しします。
「翻訳が追いつかない」「どのドキュメントが最新か分からない」「結局、英語のページしか読まれない」……そんな悩み、聞き飽きるほど聞いてきました。安心してください。Confluenceは「文書置き場」ではなく「ナレッジの循環装置」として設計すれば、言語の壁は崩せます。
さあ、あなたのチームを世界基準へ押し上げるための「多言語運用アーキテクチャ」を構築しましょう。
—
1. ページ階層設計：言語を「構造」に埋め込む
まず大前提。フォルダを分けるような感覚で言語を混ぜると、必ず崩壊します。「言語は階層のルートに置く」のが鉄則です。
推奨する階層設計:
/Space Home (Global Portal)
├── /en (英語ルート)
│ ├── /Getting-Started
│ └── /API-Specs
└── /ja (日本語ルート)
├── /Getting-Started (英語版と対になるページ)
└── /API-Specs
- 命名規則の極意: ページタイトルは、可能な限りIDやパスを統一します。例えば、英語が `Getting-Started` なら、日本語も `Getting-Started` を親パスにし、ページタイトルのみ `はじめに (Getting Started)` とします。これにより、URLの末尾が一致し、後述するマクロでの紐付けが劇的に楽になります。
2. 魔法のツール「Translations for Confluence」
初心者の方が「自作でなんとかしよう」と考えるのは危険です。まずは、Atlassian Marketplaceの「[Translations for Confluence](https://marketplace.atlassian.com/apps/1212173/translations-for-confluence)」などのプラグインを導入してください。
導入のHelloWorld:
1. インストール: Marketplaceからインストール。
2. マッピング: 英語ページと日本語ページをプラグイン上で「リンク」させます。
3. 動作確認: ページ上部に「Language Switcher」が現れます。ボタン一つで原文と訳文を行き来できる。これだけで、「どこに翻訳があるの？」という無駄なチャットが激減します。
3. 「情報のズレ」を防ぐ：自動化アラートの構築
一番の悪は「原文は更新されたが、翻訳版が古いまま放置されること」です。これを防ぐために、「翻訳ステータス」をラベル（Label）で管理し、Automation for Jira/Confluenceで検知させます。
自動化レシピ（Automation）:
- トリガー: 「ページの更新」
- 条件: 「英語の階層（/en）であること」かつ「ラベルに `needs-translation` を付与」
- アクション:
- 翻訳版のページに「原文が更新されました。最新の変更点を確認してください」というコメントを自動投稿する。
- 翻訳担当者のSlackチャンネルに通知を送る。
これで、「後で翻訳しよう」という曖昧な記憶に頼る必要はなくなります。仕組みがあなたを急かしてくれるからです。
4. ナレッジのサイロ化を防ぐ「グローバル・シングル・ソース」
ここが最も重要なマインドセットです。「翻訳は二次創作ではない」と考えてください。
- 図解・コードは共有する: Confluenceの「Includeマクロ」を使い、アーキテクチャ図や共通設定ファイルなどの「非言語情報」は、英語のページから参照（Include）するようにします。画像やコードを二重管理してはいけません。
- 英語をマスターにする: 原則として、仕様書の原本は英語に書き、日本語はそれを補完する「ローカライゼーション」という位置付けにします。これにより、「正解はどこか？」という問いに対する答えが常に一つになります。
—
最後に：あなたへのアドバイス
新しいツールを導入する際、最初から完璧な自動化を目指すと疲弊します。まずは「階層を分ける」ことと、「翻訳版へのリンクをページ内に設置する」こと。この2点だけを今すぐ実行してみてください。
ドキュメント管理は、単なる事務作業ではありません。「チームの思考を同期させるためのエンジニアリング」です。
あなたが設計したこの仕組みは、明日、新しいメンバーが海外から入ってきた時に、その人が迷わずプロジェクトの全貌を理解するための強力な羅針盤になります。
さあ、今日から一つ、ドキュメントの構造を見直してみましょう。その小さな一歩が、チームのベロシティを劇的に加速させるはずです。応援していますよ！