translated communication-tooling - jp

Author: yuhattor

translation/japanese/patterns/communication-tooling.md

@@ -1,50 +1,50 @@
 ## Title
 
-Communication Tooling
+コミュニケーションツール
 
 ## Patlet
 
-InnerSourceのプロジェクトは、元の開発チームの外で使用されていますが、ユーザーはヘルプを得たり、プロジェクトチームと連絡を取るのに苦労しています。このアイデアは、ディスカッションが可視化され、アーカイブされ、検索可能になることを可能にする標準的なコミュニケーションツールを設定し、文書化することです。
+インナーソースのプロジェクトは、開発チームの外で使用されていますが、ユーザーはヘルプを得たり、プロジェクトチームと連絡を取るのに苦労しています。 このアイデアは、ディスカッションが可視化され、アーカイブされ、検索可能になることを可能にする標準的なコミュニケーションツールを設定し、文書化することです。
 
 ## 状況
 
-あるチームが他のチームのコンポーネントに依存している。その部品にコントリビュートしたい。文章であっても、コミュニケーションは1対1で行われる。
+チームは別のチームのコンポーネントに依存しており、そのコンポーネントにコントリビュートしたいと思いっています。コミュニケーションは文書で行われる場合でも、1対1で行われています。
 
 ## 問題
 
 チームは、そのコンポーネントのダウンストリームユーザーからのコントリビューションを受け入れることができます。しかし、調整とコミュニケーションはアドホックな方法で行われ、支離滅裂な情報が共有されたり、回答が遅れたり、コントリビューターが明確な回答を受け取る前に複数のホストチームのメンバーに問い合わせをしたりすることがあります。
 
 ## ブロッカーとなりうるちから  (Forces)
 
-* ホストチームは、コントリビューションを受けることに関心があり、コントリビューターを指導する意思がある。
-* チームは口頭でのコミュニケーション文化が強く、プロジェクト特有の非同期コミュニケーションチャネルの設定に経験が浅い。
-* コミュニケーションチャネルは、到達すべき特定のグループと連携しているかもしれないが、コミュニケーションの目的によって連携しているわけではない。
+* ホストチームはコントリビューションを受けることに興味があり、コントリビューターを指導することに積極的です。
+* チームは口頭でのコミュニケーション文化が強く、プロジェクト特有の非同期コミュニケーションチャンネルを設定する経験は浅いです。
+* コミュニケーションチャネルは、連絡を取るべき特定のグループと連携しているかもしれませんが、コミュニケーションの目的によって連携しているわけではありません。
 
 ## ソリューション
 
 ホストチームは、社内で公開され、アーカイブされ、検索可能で、リンク可能なコミュニケーション・チャネルを提供することの利点を明確にする必要があります。
 
-InnerSourceプロジェクトのコミュニケーション・チャンネルを合理化する際のゴールは、特定の人々の周りではなく、トピックの周りのコミュニケーションを調整することです。
+インナーソースプロジェクトのコミュニケーションチャネルを合理化する際の目標は、特定の人々の周りではなく、トピックの周りのコミュニケーションを調整することであるべきです。
 
-* プロジェクトは、ホストチームのメンバーだけでなく、下流のユーザーやコントリビューターもフォローできるように、構造化されたコミュニケーション、意思決定、進捗追跡が透過的に行われる独自の課題トラッカーを持っている必要があります。
+* プロジェクトは、ホストチームのメンバーだけでなく、ダウンストリームユーザーやコントリビューターもフォローできるように、構造化されたコミュニケーション、意思決定、進捗追跡が透過的に行われる独自のイシュートラッカーを持っている必要があります。
 * プロジェクトは、あまり厳密でない構造を持つ1つ以上のディスカッションチャンネルを持つべきです。一般的に、これはメーリングリスト、オンラインフォーラム、あるいはアーカイブされたチャットチャンネルになります。通常、プロジェクトのためのチャンネルは1つで十分ですが、トラフィックが増えすぎた場合は、プロジェクトの使用に関する議論とプロジェクトの開発に関する議論を分けることが有用です。
-* さらに、プロジェクトは [Trusted Committers] (../../patterns/2-structured/trusted-committer.md) の間で機密のやりとりができるプライベートチャンネルを一つ持つべきです - たとえば、ホストチームにさらに Trusted Committers を追加するなどです。このチャンネルは、デフォルトではオープンで非常に稀な状況下でのみ非公開になるように、細心の注意を払って使用されるべきです。
+* さらに、プロジェクトは[信頼されたコミッター](./trusted-committer.md) の間で機密のやりとりができるプライベートチャンネルを一つ持つべきです - たとえば、ホストチームにさらに信頼されたコミッターを追加するなどです。このチャンネルは、デフォルトではオープンで、非常に稀な状況下でのみ非公開になるように、細心の注意を払って使用されるべきです。
 
-文書化されたチャンネル以外でもコミュニケーションは可能ですが、できるだけ多くの情報を非同期チャンネルに持ち帰るべきです。
+文章での共有のチャンネル以外でもコミュニケーションは可能ですが、できるだけ多くの情報を非同期チャンネルにつなぐべきです。
 
-すべてのコミュニケーション・チャンネルはプロジェクトの `README.md` で文書化されるべきです。ホストチームのメンバーは、個人的に受けた質問を公式のコミュニケーション・チャンネルに戻すよう努力する必要があります。
+すべてのコミュニケーション・チャンネルはプロジェクトの `README.md` で文書化されるべきです。ホストチームのメンバーは、個人的に受けた質問を公式のコミュニケーションチャンネルに戻すよう努力する必要があります。
 
 ## 結果の状況
 
-公式の非同期コミュニケーションチャネルを設定し、一貫して使用することで、同じような質問が再び出てきたときに参照できる、基本的なレベルの受動的な文書を作成することができます。
+公式の非同期コミュニケーションチャネルを設定し、一貫して使用することで、同様の質問が再び出てきたときに再び参照できる受動的なドキュメントのベースレベルを作成することができます。
 
-コミュニケーションがオープンに行われることで、他の人も簡単にプロジェクトの進捗を追うことができ、積極的にコントリビュートすることができます。また、他の参加者が潜んで読んでいることで、参加するための障壁が低くなり、コントリビューションを受ける可能性が高くなります。
+コミュニケーションがオープンに行われることで、他の人も簡単にプロジェクトの進捗を追うことができ、積極的に貢献することができます。また、他の参加者が潜んで読んでいることで、参加するための障壁が低くなり、コントリビューションを受ける可能性が高くなります。
 
-質問に対する回答が公開されることで、より多くの人が自分の視点を追加し、全体像を把握することができます。これは、ホストチームのメンバーだけでなく、プロジェクトのユーザーも含まれます。
+質問に対する回答が公開されることで、より多くの人が自分の視点を追加し、全体像を把握することができます。これは、ホストチームのメンバーだけでなく、プロジェクトのユーザーも含みます。
 
-非同期チャネルでコミュニケーションをとることで、タイムゾーンや会議のスケジュール、チームのルーチンなど、異なるスケジュールの参加者がプロジェクトに有意義にコントリビュートすることができます。
+非同期チャネルでコミュニケーションをとることで、タイムゾーンや会議のスケジュール、チームのルーチンなど、異なるスケジュールの参加者がプロジェクトに有意義に貢献することができます。
 
-このようなチャンネルで質問に答えることは、他のチームメンバーがそれを聞いて追加情報を提供できるだけでなく、同じ質問をした他のユーザーが前回の回答を見る（または後で見つける）ことで、説明を繰り返す必要性を低くすることを意味します。
+このようなチャンネルで質問に答えることは、他のチームメンバーがそれを聞いて追加情報を提供できるだけでなく、同じ質問をした他のユーザーが前回の回答を見る(または後で見つける)ことで、説明を繰り返す必要性を低くすることを意味します。
 
 ## 事例
 
@@ -59,3 +59,7 @@ Isabel Drost-Fromm
 
 * Structured
 * Drafted in December 2019.
+
+## 翻訳の履歴
+- **2022-06-06** - 翻訳 [Yuki Hattori](https://github.com/yuhattor)
+

translation/japanese/patterns/repository-activity-score.md

@@ -35,7 +35,7 @@ GitHub API で取得できる自動化された KPI は、真実の一部でし
 
 ## スケッチ
 
-リポジトリ活性度スコアのエコシステム](../../assets/img/repository_activity_score.png)
+![リポジトリ活性度スコアのエコシステム](../../../assets/img/repository_activity_score.png)
 
 リポジトリ活性度スコアの計算と適用を一元化したもの。詳しくは、【結果コンテキスト】(#resulting-context)をご覧ください。