44
55## Patlet
66
7- 潜在的なコントリビューターは、彼らの助けを必要とするアクティブなInnerSourceプロジェクトを見つけたいと思っています。各プロジェクトのリポジトリ活動スコアを計算することで 、プロジェクトのランク付けされたリストを作成することができます(例: [ InnerSource Portal ] ( innersource-portal.md ) ) 、そのため、潜在的コントリビューターは、彼らがコントリビュートしたいプロジェクトをより簡単に決定できます。
7+ 潜在的なコントリビューターは、彼らの助けを必要とするアクティブなインナーソースプロジェクトを見つけたいと思っています。各プロジェクトのリポジトリのアクティビティスコアを計算することで 、プロジェクトのランク付けされたリストを作成することができます (参考: [ インナーソースポータル ] ( innersource-portal.md ) ) 、そのため、潜在的コントリビューターは、彼らがコントリビュートしたいプロジェクトをより簡単に決定できます。
88
99## 問題
1010
11- ** InnerSourceのプロジェクトはどのような順番で表示されるのでしょうか?GitHub Stars * , * Number of Forks * , * Number of Commits * , * Lines of Code * , * Last Update * などの典型的なランキング KPI は、プロジェクトの活動状況を簡潔に示すには十分ではありません。
11+ ** インナーソースのプロジェクトはどのような順番で表示されるべきでしょうか? ** * GitHubのスター数 * , * フォーク数 * , * コミット数 * , * コードの行数 * , * 最終更新日時 * などの典型的なKPI は、プロジェクトの活動状況を簡潔に示すには十分ではありません。
1212
13- 活発なプロジェクトはもちろん、新しいコントリビューターを必要としているかなり新しく熱心なプロジェクトも、成熟したプロジェクトで活動が少ないものやメンテナンス中のものよりも上位にランクされるべきです 。
13+ 活発なプロジェクトはもちろん、新しいコントリビューターを必要としているかなり新しく熱心なプロジェクトも、成熟したプロジェクトで活動が少ないものやメンテナンス中のものよりも上位にランクされるべきでしょう 。
1414
15- プロジェクトの活動レベルについて、信頼性が高く汎用性のあるスコアを定義するために、いくつかのKPIから派生した新しい評価指標が必要である。
16- この指標は、プロジェクトの活動レベルに応じて、プロジェクトを分類するために使用される。
15+ プロジェクトのアクティビティレベルについて、信頼性が高く汎用性のあるスコアを定義するために、いくつかのKPIから派生した新しい評価指標が必要になります。この指標は、プロジェクトのアクティビティレベルに応じて、プロジェクトを分類するために使用されます。
1716
1817## ケーススタディ
1918
20- InnerSourceが長い間実践されているか、プロジェクトの特定の数(意味のある閾値を与えるために50としましょう)を超えてスケールしている場合、それは現在最も人気のあるとアクティブInnerSourceプロジェクトを見つけることは困難である。 長い間存在するプロジェクトはよく知られていますが、もはや非常にアクティブではないかもしれません。 一方、かなり新しいプロジェクトは、まだ評判や活発なコミュニティを持っていません 。
19+ インナーソースが長期間実践されている場合、または特定の数のプロジェクト(意味のあるしきい値を与えるために50としましょう)を超えて拡がっている場合、現在最も人気がありアクティブなインナーソースプロジェクトを見つけるのは困難です。 長い間存在するプロジェクトはよく知られていますが、もはやあまり活発ではないかもしれません。 一方、かなり新しいプロジェクトには、まだ評判や活発なコミュニティがありません 。
2120
22- InnerSource プロジェクトのリストは 、静的なリソースと考えるべきではありませんが、ちょうどその日の最も興味深いトピックを最初にリストするニュースページのように、新しいアクティブなプロジェクトを発見し探索するためのエキサイティングな場所です。したがって、プロジェクトの順序が定期的に更新され、プロジェクトの人気と活動に応じて変更された場合、それは有益である 。
21+ インナーソースプロジェクトのリストは 、静的なリソースと考えるべきではありませんが、ちょうどその日の最も興味深いトピックを最初にリストするニュースページのように、新しいアクティブなプロジェクトを発見し探索するためのエキサイティングな場所です。したがって、プロジェクトの順序が定期的に更新され、プロジェクトの人気と活動に応じて変更された場合、それは有益であると言えます 。
2322
24- このプロトタイプは驚くほどうまく機能し、プロジェクトの活動状況に応じて常に変化する順序を決定します。
23+ これらの考慮事項を加味し、リポジトリアクティビティスコアを計算する最初のプロトタイプが開発されました。
24+ このプロトタイプは驚くほどよく機能し、プロジェクトの活動状況に応じて常に変化する順序を決定することができます。
2525
2626## 状況
2727
28- InnerSourceプロジェクトの発見は、 [ InnerSource Portal ] ( innersource-portal.md ) と [ Gig Marketplace ] ( gig-marketplace.md ) パターンで促進されるか、他のコミュニケーションチャンネルやプラットフォームでプロジェクトを促進することで可能になります。活動スコアは 、プロジェクトがコミュニティに提示されるデフォルトの順序を定義しています。
28+ インナーソースプロジェクトの発見は、 [ インナーソースポータル ] ( innersource-portal.md ) と [ ギグマーケットプレイス ] ( gig-marketplace.md ) パターンで促進されるか、他のコミュニケーションチャネルやプラットフォームでプロジェクトを促進することで可能になります。アクティビティスコアは 、プロジェクトがコミュニティに提示されるデフォルトの順序を定義しています。
2929
30- ## ブロッカーとなりうるちから (Forces)
30+ ## ブロッカーとなりうるちから(Forces)
3131
32- GitHub API で取得できる自動化された KPI は、真実の一部でしかありません 。コードの品質や優れたドキュメントの有無、活発で助け合うコミュニティなど、そのプロジェクトが楽しくコントリビュートできる場所であるかどうかはどうでしょうか 。
32+ GitHub API で取得できる自動化された KPI は、全ての事柄のうち一部しか示せていません 。コードの品質や優れたドキュメントの有無、活発で助け合うコミュニティなど、そのプロジェクトが楽しくコントリビュートできる場所であるかどうかも重要な事項です 。
3333
34- このような「ソフトな」KPIは 、手動または半自動で計算と結果のスコアに追加する必要があります。もし、コードカバレッジレポートのような、リポジトリにより多くのコンテキストを提供するツールがあれば、簡単に取り入れることができます。
34+ このような「ソフトなKPI」は 、手動または半自動で計算と結果のスコアに追加する必要があります。もし、コードカバレッジレポートのような、リポジトリにより多くのコンテキストを提供するツールがあれば、簡単に取り入れることができます。
3535
3636## スケッチ
3737
3838![ リポジトリ活性度スコアのエコシステム] ( ../../../assets/img/repository_activity_score.png )
3939
40- リポジトリ活性度スコアの計算と適用を一元化したもの 。詳しくは、【結果コンテキスト】(#resulting-context )をご覧ください。
40+ こちらはリポジトリアクティビティスコアの計算と適用をまとめたものです 。詳しくは、[ 結果の状況 ] ( #結果の状況 ) をご覧ください。
4141
4242## ソリューション
4343
44- リポジトリ活性度スコアは、InnerSourceプロジェクトの( GitHub) 活性度を表す数値です。GitHubスター、ウォッチ、フォークなどのリポジトリ統計から自動的に導き出され、他のツールからのKPIや手動評価でリッチ化されることもあります 。
44+ リポジトリアクティビティスコアは、インナーソースプロジェクトの( GitHub) 活性度を表す数値です。GitHubスター、ウォッチ、フォークなどのリポジトリ統計から自動的に導き出され、他のツールからのKPIや手動評価で付加情報が足されることもあります 。
4545
4646さらに、最終更新日やレポの作成日などの活動パラメータを考慮し、多くのトラクションを持つ若いプロジェクトに活力を与えます。
47- コントリビューションガイドライン、積極的な参加統計、課題( 公開バックログ) を持つプロジェクトも、より高いランキングを受け取ります。
47+ コントリビューションガイドライン、積極的な参加統計、課題( 公開バックログ) を持つプロジェクトも、より高いランキングを受け取ります。
4848
49- これらはすべて、[ GitHub search API] ( https://docs.github.com/en/rest/search#search-repositories ) と [ GitHub statistics API] ( https://docs.github.com/en/rest/metrics/statistics ) の結果セットを使って自動的に取得 ・計算することが可能です。BitBucket、Gitlab、Gerritのような他のコード・バージョニング・システムも、同様のAPIがあれば統合することが可能です。
49+ これらはすべて、[ GitHub search API] ( https://docs.github.com/en/rest/search#search-repositories ) と [ GitHub statistics API] ( https://docs.github.com/en/rest/metrics/statistics ) の結果を使って自動的に取得 ・計算することが可能です。BitBucket、Gitlab、Gerritのような他のコード・バージョニング・システムも、同様のAPIがあれば統合することが可能です。
5050
51- 以下のコードでは、変数 ` repo ` に GitHub ` search ` API から取得したエンティティを、` Participation ` オブジェクトに GitHub ` stats/participation ` API から取得したエンティティを格納していると仮定しています 。
51+ 以下のコードでは、変数 ` repo ` に GitHub ` search ` API から取得したエンティティを、` Participation ` オブジェクトに GitHub ` stats/participation ` API から取得したエンティティを格納することを仮定しています 。
5252
53- 必要であれば、ソフトKPI( [ Forces ] ( #forces ) を参照) に従って手動で調整することもできます。
53+ 必要であれば、ソフトKPI( [ ブロッカーとなりうるちから ] ( #ブロッカーとなりうるちから(Forces) ) を参照) に従って手動で調整することもできます。
5454
5555``` javascript
5656// calculate a virtual InnerSource score from stars, watches, commits, and issues
@@ -102,19 +102,19 @@ function calculateScore(repo) {
102102
103103## 結果の状況
104104
105- コントリビューターは、InnerSourceプロジェクトに自分の時間の一部をコミットするために自由である。彼らはとにかく彼らの通常のチームでの作業のために依存しているプロジェクトにコントリビュートすることを選択することがあります 。しかし、彼らはまた、彼らの興味や個人的な開発目標に基づいて、完全に異なるものにコントリビュートすることを選択することができます 。
105+ コントリビューターは、時間の一部をインナーソースプロジェクトに自由にコミットできます。 彼らはまっさきに彼ら自身のチームの仕事において使っているプロジェクトへのコントリビューションを選ぶかもしれません 。しかし、人によってはそれぞれの興味や個人的な開発目標に基づいて、まったく異なる何かにコントリビュートすることを選択するかもしれません 。
106106
107- プロジェクトは、リポジトリ活動スコアでソートして表示することができ、新しいコントリビューターの候補にプロジェクトを提示するポータルで意味のある順序を与えることができます。スコアはその場で計算することもできますし、定期的にすべてのプロジェクトを評価し、結果のリストを保存するバックグラウンドジョブで計算することもできます 。
107+ プロジェクトはリポジトリアクティビティスコアで並べ替えて表示できるため、ポータルで意味のある順序を指定して潜在的な新しいコントリビューターに見てもらうことができます。スコアは、プロジェクト進行中に計算することも、すべてのプロジェクトを定期的に評価して結果のリストを保存するバックグラウンドジョブで計算することもできます 。
108108
109- 定期的にすべてのInnerSourceリポジトリ(例: GitHubで特定の[topic ](https://github.com/topics)でタグ付けされたもの)を検索するクローラーも有用な追加機能になりえます。これは、[InnerSource Portal ](innersource-portal.md) のようなツール、検索エンジン、または対話型チャットボットの入力として使用できるプロジェクトのランク付けされたリストを提供するものです 。
109+ 定期的にすべてのインナーソースリポジトリ(例: GitHubで特定の[トピック ](https://github.com/topics)でタグ付けされたもの)を検索するクローラーも有用な追加機能になりえます。これは、[インナーソース ポータル ](innersource-portal.md)のようなツール、検索エンジン、または対話型チャットボットでランク付けされたプロジェクトリストを探せるようにするツールも候補になり得ます 。
110110
111111## 理論的解釈
112112
113- リポジトリ活性度スコアは 、GitHub API に基づくシンプルな計算です。完全に自動化することができ、新しい要件にも簡単に対応することができます。
113+ リポジトリアクティビティスコアは 、GitHub API に基づくシンプルな計算です。完全に自動化することができ、新しい要件にも簡単に対応することができます。
114114
115115## 事例
116116
117- * SAPのInnerSourceプロジェクトポータルで、InnerSourceプロジェクトのデフォルトの順序を定義するために使用されます 。2020年7月に初めて作成され、それ以来、頻繁に微調整や更新が行われている。2020年7月にInnerSourceCommonsに提案したところ、このパターンが出現した 。また、[Michael Graf & Harish B (SAP) at ISC.S11 - The Unexpected Path of Applying InnerSource Patterns](https://www.youtube.com/watch?v=6r9QOw9dcQo&list=PLCH-i0B0otNQZQt_QzGR9Il_kE4C6cQRy&index=6) もご参照ください。
117+ * SAPのインナーソースポータルで、インナーソースプロジェクトのデフォルトの順序を定義するために使用されています 。2020年7月に初めて作成され、それ以来、頻繁に微調整や更新が行われています。2020年7月にこのことを InnerSourceCommons に提案したところ、このパターンが確立しました 。また、[Michael Graf & Harish B (SAP) at ISC.S11 - The Unexpected Path of Applying InnerSource Patterns](https://www.youtube.com/watch?v=6r9QOw9dcQo&list=PLCH-i0B0otNQZQt_QzGR9Il_kE4C6cQRy&index=6) もご参照ください。
118118
119119## ステータス
120120
@@ -126,9 +126,12 @@ function calculateScore(repo) {
126126
127127## 謝辞
128128
129- Thank you to the InnerSource Commons Community for lightning-fast advice, and a lot of helpful input to feed this pattern! Especially:
129+ InnerSource Commons Community の迅速なアドバイス、そしてこのパターンを養うための多くの有益な意見に感謝します!
130130
131131* Johannes Tigges
132132* Sebastian Spier
133133* Maximilian Capraro
134134* Tim Yao
135+
136+ ## 翻訳の履歴
137+ - **2022-06-07** - 翻訳 [Yuki Hattori](https://github.com/yuhattor)
0 commit comments