翻訳について

このドキュメントは英語で書かれています。より多くの人に役立ててもらうため、機械翻訳版も公開しています。このページでは、それが読者にとって何を意味するのか、そして改善に協力する方法を説明します。

利用できる言語

翻訳版のドキュメントは現在、Deutsch、español、français、हिन्दी、日本語、한국어、português（Brasil）、русский язык、Türkçe、українська мова、简体中文、繁體中文の 12 言語でプレビューとして提供しています。各ページ上部の言語切り替えから選んでください。これらの言語で実績が得られれば、ほかの言語も追加されるかもしれません。

API リファレンスは翻訳されません。翻訳版のサイトからは、英語版の API リファレンスにリンクしています。

正となるのは英語版

翻訳されたページと英語の原文が食い違う場合は、英語のページが正しいものです。翻訳版サイトのすべてのページの冒頭には、そのページの状態を示す次の 3 つの注記のいずれかが表示されます。

• 機械翻訳：ページは自動的に翻訳されたもので、英語の原文へのリンクがあります。
• 英語版より古い翻訳：翻訳後に英語の原文が変更されたため、翻訳が追いつくまで一部の内容が古くなっている可能性があります。
• 英語で表示：そのページの最新の翻訳がないため、英語のテキストが表示されています。

翻訳の作り方

翻訳されたページは、このリポジトリにあるツールが docs/ 配下の英語ページから機械的に生成します。その際、言語ごとに人の手で書かれた 2 つの入力が指針になります。1 つはスタイルガイド（文体、トーン、表記、冗談や慣用句の扱い方）、もう 1 つは用語集（英語のまま残す用語と、それ以外の用語に対する必須の訳語・禁止する訳語）です。生成されたテキストを手で編集することはありません。改善はすべてこれらの入力に反映します。そうすることで、次にページを再生成したときにも改善が失われません。

翻訳の問題を報告する

誤った用語、ぎこちない文、英語版にない内容が書かれた翻訳を見つけた場合は、言語、ページ、該当箇所を添えて issue を作成してください。ネイティブスピーカーからの報告は特に貴重です。修正方法がわかっている場合は、i18n/ 配下にあるその言語のスタイルガイド（instructions.md）または用語集（glossary.json）へのプルリクエストとして直接提案してください。次に翻訳を再生成したときに、影響を受けるすべてのページに修正が反映されます。英語のテキスト自体の問題は、ほかのドキュメントの変更と同様に、docs/ 配下のページで修正します。