翻訳

DispatchAtlas は、12 のロケールからなるコホートでドキュメントを提供します。英語がソースで、 他のすべてのロケールは翻訳ターゲットです。このページは、今日翻訳されているもの、翻訳品質を 統べる規律、そして翻訳を貢献する手順を述べます。

ロケールコホート

サイトは 12 のロケールを登録します — サイトルートの英語と、11 の接頭辞付き翻訳ターゲット:

各ページは自身の lang を宣言し、アラビア語はさらに右から左にレンダリングされ、対称的な hreflang セットと英語ページを指す x-default がコホートを検索エンジン向けに連結します。 ある与えられたページをまだ翻訳していないロケールは、そのページの hreflang エントリを英語に 向ける代わりに省略するため、不在が正確に報告されます。

現在のカバレッジ

インターフェースのクロム — ナビゲーション、コントロール、検索、フッター — は 12 のロケール すべてにわたって翻訳されています。ドキュメントページは漸進的に翻訳されます; 要求された ロケールに翻訳のないページは英語ソースをフォールバックとしてレンダリングするため、どの ルートも決して壊れません。カバレッジは下記のレビューパイプラインの下でページごとに成長し、 言語スイッチャーは常に各ページに少なくとも英語形式で到達します。

機械シード＋人間レビューのパイプライン

翻訳品質はリリース基準であり、後付けではありません。2 つの段階が各翻訳ページを統べます:

1. 機械シード。 ページはまず、ロケールごとのグロッサリに対して機械翻訳で下書きされます。 グロッサリはドメイン語彙（スケジューリング、dispatch、ベンチマーク、ソルバー、目的、 制約）をロケールごとに一貫した一つの用語に固定します。
2. 人間レビュー。 母語が流暢なレビュアーが、出荷前にシードを流暢さ・用語・トーンについて 修正します。機械シードされたコピーは決して最終の未レビューテキストとして公開されません。

ページがあるロケールでリリース準備完了となるのは、レビュアーがそれを証明した後のみです。 それまでは英語フォールバックが立ち、部分的-翻訳ではなく正確かつ完全です。

翻訳の貢献

1. site/content/docs/en/ 配下のページとターゲットロケールを選びます。
2. 同じ相対 slug と同じ frontmatter キー（title、description）で site/content/docs/<locale>/ 配下にミラーパスを作成します。
3. ロケールのグロッサリを尊重して本体を翻訳し、ドメイン用語がそのロケールの他の部分と 一貫するようにします。
4. 各コードブロック、コマンド、識別子、リンクターゲット、図参照をソースと同一に保ちます — 自然言語の散文のみが翻訳されます。
5. 母語が流暢なレビューのために貢献を開きます。証明されると、ページはそのロケールで出荷され、 その hreflang エントリがコホートに追加されます。

リポジトリのワークフローと、すべての変更に適用されるレビュープロセスについては 貢献ガイドを参照してください。