Japanese version is ready for review

[kkomazaw]

I included a Japanese version of this guidebook under l10n/ja. I am glad if it can be merged.

[semioticrobotic]

This is awesome, @kkomazaw. Fantastic work! And thank you. 🙏

At the moment, we don't (to my knowledge) have many community members qualified to help review your PR. But I've sent a call for volunteers and hope that we'll see a few new faces arrive to help us get this merged.

Again, thank you! ⭐️

[shu-mutou]

まだ少ししかレビューしていませんが、全体的に「オープンソース・ウェイ」の「・」をどうしたものかご検討いただきたく、一旦ここまでにします。

Although I have only reviewed a small amount so far, there is a point that I would like you to consider overall, so I will end my review here.

[shu-mutou]

空行は他のファイルに合わせて「なし」にしませんか。

[kkomazaw]

これはどういう意味でしょうか？お手数ですがもう少し詳しく教えてください。

[shu-mutou]

Rawで見ると、空行が幾つかあるようです。

[kkomazaw]

Thank you very much for your support,Shu. I will fix all as your advices.

[shu-mutou]

ルートにある大文字ファイルのレビューを完了しました。他の内容は、また別途実施します。

Completed review of uppercase files on the root directory. Other contents will be carried out separately.

[shu-mutou]

Rawで見ると、空行が幾つかあるようです。

[shu-mutou]

https://creativecommons.org/licenses/by-sa/4.0/deed.ja
が日本語版の原本のようなので、ここからまるっとコピーした方が良いと思います。

最後のリーガルコードのURLの日本語版は以下のようです。
https://creativecommons.org/licenses/by-sa/4.0/legalcode.ja

[shu-mutou]

中途半端ですが、時間的制約により、一旦レビューを区切ります。
It's only half-finished, but due to time constraints, I'll break up the review for now.

[shu-mutou]

本日もキリが悪いですが、時間切れです。

I'm running out of time today.

[shu-mutou]

Suggested change

	「新米ママの自由時間は通常1日1時間未満です。私にとっての鍵は、自分がやりたいオープンソース活動と、職場が報酬を支払うオープンソース活動を一致させることでした。産休明けにはCVEバイナリツールのオープンソース化に取り組み、メンターとしての役割で学生を指導する時間を確保できるよう上司と調整しました。」
	「新米ママの自由時間は通常1日1時間未満です。私にとっての鍵は、自分がやりたいオープンソース活動と、職場が報酬を支払うオープンソース活動を一致させることでした。産休明けにはCVEバイナリツールのオープンソース化に取り組み、メンテナーとして学生を指導する時間を確保できるよう上司と調整しました。」

[shu-mutou]

Suggested change

	例えば、プロジェクトの_ユーザー_と_開発者_という基本的な区別を考えてみましょう。ソフトウェアの_使用_に関心のある人は、インストール方法、設定方法、手元のタスク（例：ウェブサイトの構築）を達成するために必要な知識などに興味を持つでしょう。開発者もこうした詳細には関心を持ちますが、プロジェクトに効果的に貢献するためには追加情報が必要となります。
	例えば、プロジェクトの_ユーザー_と_開発者_という基本的な区別を考えてみましょう。ソフトウェアの_使用_に関心のある人は、インストール方法、設定方法、手元のタスク（例：ウェブサイトの構築）を達成するために必要な知識などに興味を持つでしょう。開発者もこうした詳細には関心を持ちますが、プロジェクトに効果的に貢献するためには追加情報が必要となります。

ditto

[shu-mutou]

Suggested change

	問題解決に役立つソフトウェアの情報を探す際、人々が最初に訪れるのはプロジェクトウェブサイトでしょう。
	問題解決に役立つソフトウェアの情報を探す際、人々が最初に訪れるのはプロジェクトウェブサイトでしょう。

ditto

[shu-mutou]

Suggested change

	プロジェクトウェブサイトの目立つ場所に、プロジェクトの簡潔な概要を掲載しましょう。この説明には、コードベースが何を目的として設計されているか、そしてそれを使用することで解決できる可能性のある問題を含める必要があります。この情報を簡潔かつ見つけやすくすることが重要です。プロジェクトのホームページに簡単な説明を掲載し、関心のある人がすぐにプロジェクトが自身のニーズを満たすように設計されているかどうかを判断できるようにしましょう。
	プロジェクトウェブサイトの目立つ場所に、プロジェクトの簡潔な概要を掲載しましょう。この説明には、コードベースが何を目的として設計されているか、そしてそれを使用することで解決できる可能性のある問題を含める必要があります。この情報を簡潔かつ見つけやすくすることが重要です。プロジェクトのホームページに簡単な説明を掲載し、関心のある人がすぐにプロジェクトが自身のニーズを満たすように設計されているかどうかを判断できるようにしましょう。

ditto

[shu-mutou]

レビュー結果反映ありがとうございます！一旦レビュー停止します。

[shu-mutou]

Suggested change

	新規ユーザーや参加者を対象としたプロジェクトの「はじめに」ガイドには、プロジェクトに不慣れな人が支援を受けられる他の場所に関する情報を可能な限り含めましょう。例えば、メンタリングや初心者支援を好むメンバーが常駐する「newbies」というSlackチャンネルがある一方、継続的な開発議論は「developer」チャンネルで行われるといったケースが考えられます。
	新規ユーザーや参加者を対象としたプロジェクトの「入門」ガイドには、プロジェクトに不慣れな人が支援を受けられる他の場所に関する情報を可能な限り含めましょう。例えば、メンタリングや初心者支援を好むメンバーが常駐する「newbies」というSlackチャンネルがある一方、継続的な開発議論は「developer」チャンネルで行われるといったケースが考えられます。

[shu-mutou]

Suggested change

	非目標の文書化は、商業的に焦点を当てたプロジェクトにおいて特に重要です。貢献者がオープンソースとして機能を作成したいという願望が、ベンダーが独自機能を開発する目標と衝突する可能性があるためです。貢献者は依然としてその機能をオープンソースとして作成することを選択するかもしれませんが、彼らは最初から、上流のメンテナがその作業をプロジェクトのコードベースの一部として含める意図がないことを知るべきです。ベンダーが代わりに開発していると知れば実装を控える者もいれば、プロジェクトのメインソースツリーに組み込まれないと知れば、継続的なメンテナンス負担を自ら負いたくないため実装を断念する者もいます。また、プロジェクトのメインソースリポジトリに組み込まれるか否かに関わらず、自社のニーズに合致するものを開発しオープンソースとして公開する者もいます。
	非目標の文書化は、商業的に焦点を当てたプロジェクトにおいて特に重要です。貢献者がオープンソースとして機能を作成したいという願望が、ベンダーが独自機能を開発する目標と衝突する可能性があるためです。貢献者は依然としてその機能をオープンソースとして作成することを選択するかもしれませんが、彼らは最初から、上流のメンテナがその作業をプロジェクトのコードベースの一部として含める意図がないことを知るべきです。ベンダーが代わりに開発していると知れば実装を控える者もいれば、プロジェクトのメインソースツリーに組み込まれないと知って、継続的なメンテナンス負担を自ら負いたくないため実装を断念する者もいます。また、プロジェクトのメインソースリポジトリに組み込まれるか否かに関わらず、自社のニーズに合致するものを開発しオープンソースとして公開する者もいます。

[shu-mutou]

Suggested change

	リアルタイムチャットで直接助けを求めるより面倒に思えるかもしれませんが、以下の理由から重要です。
	リアルタイムチャットで直接助けを求めるより面倒に思えるかもしれませんが、以下の理由から重要です。

[shu-mutou]

Suggested change

	ソフトウェアでは同じ問題が頻繁に発生し、多くの人がプロジェクトに課題を報告しています。同一問題の複数報告は、進行中の作業について各報告者へ個別対応する必要が生じるため、プロジェクト管理者の時間を大きく消費します。幸い、課題管理ツールでは既存課題の重複として迅速にクローズし（報告者には「元」報告で進行状況を追跡するよう案内）、このプロセスを効率化できます。
	ソフトウェアでは同じ問題が頻繁に発生し、多くの人がプロジェクトに課題を報告しています。同一問題の複数報告は、進行中の作業について各報告者へ個別対応する必要が生じるため、プロジェクト管理者の時間を大きく消費します。幸い、課題管理ツールでは既存課題の重複として迅速にクローズし（報告者には「元」報告で進行状況を追跡するよう案内）、このプロセスを効率化できます。

[shu-mutou]

Suggested change

	プロジェクト管理者は、問題を抱える全員に対して一箇所で一斉に情報を発信できるようになり、支援を必要とする全員を助けつつ、自身のワークフローを効率化できます。
	プロジェクトのメンテナーは、問題を抱える全員に対して一箇所で一斉に情報を発信できるようになり、支援を必要とする全員を助けつつ、自身のワークフローを効率化できます。

管理者とメンテナーで統一されていないところが散見されます。

[shu-mutou]

Suggested change

	「協力者募集」イシューへの応答として提出される場合は、そのイシューへの関心を表明した人物と早期かつ頻繁に連携してください。これにより、貢献者の提出物が実際にプロジェクトのニーズを満たすことが保証されます。さらに、新規貢献者と定期的に対話する姿勢を示すことで、相互学習を促し、彼らがプロジェクトの継続的な作業に貢献し続ける可能性を高める関係を築けます。
	「協力者募集」イシューへの応答として提出される場合は、そのイシューへの関心を表明した人物と早期かつ頻繁に連携してください。これにより、貢献者の提出物が実際にプロジェクトのニーズを満たすことが保証されます。さらに、新規貢献者と定期的に対話する姿勢を示すことで、相互学習を促し、彼らがプロジェクトの進行中の作業に継続的に貢献し続ける可能性を高める関係を築けます。

[shu-mutou]

Suggested change

	#### 複数の言語で利用可能なコミュニティリソースを目立つように認識する
	#### 複数の言語で利用可能なコミュニティリソースを目立つように表示する

[shu-mutou]

Suggested change

	略語は、その分野に精通した者にとって長い表現を省略する便利な手段ですが、不慣れな者にとっては情報を不明瞭にします。さらに略語は多義的であることが多く、分野によって異なる意味に展開される場合があります。例えば、プロジェクトに全く関わったことのない人は、「LGTM」が「looks good to me（問題ないと思う）」を意味し、自分の作業がプロジェクトのソースリポジトリにマージしても良い状態であることを理解できないかもしれません。プロジェクト内のコミュニケーションで特定の頭字語を頻繁に使用する場合は、これらの用語の簡易用語集を作成する時間を割いてください。この用語集の更新は、ボランティアが貢献できる迅速かつ簡単な方法です。
	略語は、その分野に精通した者にとって長い表現を省略する便利な手段ですが、不慣れな者にとっては情報を不明瞭にします。さらに略語は多義的であることが多く、分野によって異なる意味に展開される場合があります。例えば、プロジェクトに全く関わったことのない人は、「LGTM」が「looks good to me（問題ないと思う）」を意味し、自分の作業がプロジェクトのソースリポジトリにマージしても良い状態であることを理解できないかもしれません。プロジェクト内のコミュニケーションで特定の頭字語を頻繁に使用する場合は、これらの用語の簡易用語集を作成する時間を割いてください。この用語集の更新は、ボランティアが貢献するための迅速かつ簡単な方法です。

[shu-mutou]

Suggested change

	単にコミュニケーションチャネルを_列挙する_だけでは不十分です。ドキュメントでは、各チャネルの_目的_、特定のコミュニケーション手段を_いつ_使用すべきか、そしてそのチャネルを通じてプロジェクトやコミュニティメンバーから_どのような形で_連絡が来るかを明確に示さなければなりません。例えば、趣味のプロジェクトとして少数のメンテナが開発している場合、プロジェクトウェブサイトに「開発は余暇時間に行っているため、メーリングリストへの問い合わせへの即時対応は期待しないでください」と明記すると良いでしょう。一方、企業で利用されている趣味プロジェクトの担当者は、サポートが「最善を尽くす」ベースで提供されることを明示するとよいでしょう（これにより、オープンソースプロジェクトコミュニティの機能に不慣れな人々の期待を適切に設定できます）。
	単にコミュニケーションチャネルを_列挙する_だけでは不十分です。ドキュメントでは、各チャネルの_目的_、特定のコミュニケーション手段を_いつ_使用すべきか、そしてそのチャネルを通じてプロジェクトやコミュニティメンバーから_どのような形で_連絡が来るかを明確に示さなければなりません。例えば、趣味のプロジェクトとして少数のメンテナーが開発している場合、プロジェクトウェブサイトに「開発は余暇時間に行っているため、メーリングリストへの問い合わせへの即時対応は期待しないでください」と明記すると良いでしょう。一方、趣味のプロジェクトを企業で利用している担当者は、サポートが「最善を尽くす」ベースで提供されることを明示するとよいでしょう（これにより、オープンソースプロジェクトコミュニティの機能に不慣れな人々の期待を適切に設定できます）。

[shu-mutou]

Suggested change

	本章で繰り返し議論してきたように、親切で礼儀正しいコミュニケーションを維持することは、プロジェクトの持続的な健全性にとって極めて重要です。「親切で礼儀正しいコミュニケーション」の具体像を全員が理解していると仮定するのは自然に見えるかもしれませんが、参加者全員に共通の意味を期待することはできません。特にグローバルな対象者とのやり取りにおいてはなおさらです。プロジェクトのメンテナやコミュニティメンバーは模範を示すことが望ましいです。しかし、特に紛争を引き起こす可能性のある事項について、プロジェクトとのコミュニケーションにおいて何が礼儀正しい議論を構成するのか、プロジェクトの主題外となる事項は何か、誰に何を期待するのかを明示的に表明することは、プロジェクトに適切な基調を定めることになります。
	本章で繰り返し議論してきたように、親切で礼儀正しいコミュニケーションを維持することは、プロジェクトの持続的な健全性にとって極めて重要です。「親切で礼儀正しいコミュニケーション」の具体像を全員が理解していると仮定するのは自然に見えるかもしれませんが、参加者全員に共通の意味を期待することはできません。特にグローバルな対象者とのやり取りにおいてはなおさらです。プロジェクトのメンテナーやコミュニティメンバーは模範を示すことが望ましいです。しかし、特に紛争を引き起こす可能性のある事項について、何が礼儀正しい議論を構成するのか、プロジェクトの主題外となる事項は何か、プロジェクトとコミュニケーションをとるすべての人に何が期待されているのかを明示的に表明することは、プロジェクトに適切な基調を定めることになります。

[shu-mutou]

Finished attracting-users chapter once.
Remaining few notation fluctuation across documents like "メンテナ" and "管理者" etc.