Skip to content

Commit 2655611

Browse files
authored
Merge pull request #230 from spier/adding-pattern-evidence
Adding ISC Summit video from SAP to 'InnerSource Portal' and 'Repository Activity Score'
2 parents 85d4a31 + 44a8aba commit 2655611

File tree

2 files changed

+9
-11
lines changed

2 files changed

+9
-11
lines changed

patterns/2-structured/innersource-portal.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ The InnerSource Portal has enabled InnerSource project owners to advertise their
4747
## Known Instances
4848

4949
* A large financial services organization has used the creation of an InnerSource Portal to provide a mechanism of advertising and discovering InnerSource projects in existence across different business units
50-
* SAP promotes InnerSource projects in the InnerSource portal - projects can self-register using GitHub topics. The [Repository Activity Score](repository-activity-score.md) defines the default order of the InnerSource projects in the portal.
50+
* SAP promotes InnerSource projects in the InnerSource portal - projects can self-register using GitHub topics. The [Repository Activity Score](repository-activity-score.md) defines the default order of the InnerSource projects in the portal. Also see [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).
5151
* American Airlines promotes InnerSource projects via an [internal InnerSource Marketplace](https://tech.aa.com/2020-10-30-innersource/). Similarly to SAP, projects self-register by adding `innersource` as a GitHub topic. Projects are searchable and filterable by language, topics, number of open issues, etc.
5252
* The InnerSource Portal pattern has been proven to work extremely well with the associated InnerSource Gig Marketplace pattern in this context
5353

patterns/2-structured/repository-activity-score.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@ These considerations led to a first prototype to calculate a repository activity
2525

2626
## Context
2727

28-
Discovering InnerSource projects can be facilitated with the [InnerSource Portal](innersource-portal.md) and the [Gig Marketplace](gig-marketplace.md) pattern, or by promoting projects on other communication channels and platforms. The activity score defines a default order in which projects are presented to the community.
28+
Discovering InnerSource projects can be facilitated with the [InnerSource Portal](innersource-portal.md) and the [Gig Marketplace](gig-marketplace.md) pattern, or by promoting projects on other communication channels and platforms. The activity score defines a default order in which projects are presented to the community.
2929

3030
## Forces
3131

@@ -49,8 +49,8 @@ Projects with contributing guidelines, active participation stats, and issues (p
4949
All of this can be fetched and calculated automatically using the result set of the [GitHub search API](https://developer.github.com/v3/search/#search-repositories) and [GitHub statistics API](https://developer.github.com/v3/repos/statistics/). Other code versioning systems like BitBucket, Gitlab, Gerrit can be integrated as well if a similar API is available.
5050

5151
The code below assumes the variable `repo` contains an entity fetched from the GitHub `search` API and the `participation` object contains an entity from the GitHub `stats/participation` API.
52-
53-
Manual adjustments according to soft KPIs (see [Forces](#forces)) can be made on top if needed.
52+
53+
Manual adjustments according to soft KPIs (see [Forces](#forces)) can be made on top if needed.
5454

5555
``` javascript
5656
// calculate a virtual InnerSource score from stars, watches, commits, and issues
@@ -99,17 +99,15 @@ Contributors are free to commit a part of their time to InnerSource project. The
9999

100100
Projects can be sorted and presented by repository activity score to give a meaningful order in a portal presenting projects to potential new contributors. The score can be calculated on the fly or in a background job that evaluates all projects on a regular basis and stores a list of results.
101101

102-
A crawler that regularly searches all InnerSource repositories (e.g. tagged with a certain [topic](https://github.com/topics) in GitHub) can be a helpful addition as well. It provides a ranked list of projects that can be used as an input for tools like the [InnerSource Portal](innersource-portal.md), a search engine, or an interactive chat bot.
102+
A crawler that regularly searches all InnerSource repositories (e.g. tagged with a certain [topic](https://github.com/topics) in GitHub) can be a helpful addition as well. It provides a ranked list of projects that can be used as an input for tools like the [InnerSource Portal](innersource-portal.md), a search engine, or an interactive chat bot.
103103

104104
## Rationale
105105

106-
The repository activity score is a simple calculation based on the GitHub API. It can be fully automated and easily adapted to new requirements.
106+
The repository activity score is a simple calculation based on the GitHub API. It can be fully automated and easily adapted to new requirements.
107107

108108
## Known Instances
109109

110-
Used in SAP's InnerSource project portal to define the default order of the InnerSource projects. It was first created in July 2020 and is fine-tuned and updated frequently ever since.
111-
112-
When proposed to InnerSourceCommons in July 2020, this pattern emerged.
110+
* Used in SAP's InnerSource project portal to define the default order of the InnerSource projects. It was first created in July 2020 and is fine-tuned and updated frequently ever since. When proposed to InnerSourceCommons in July 2020, this pattern emerged. Also see [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).
113111

114112
## Status
115113

@@ -123,6 +121,6 @@ Proven
123121

124122
Thank you to the InnerSource Commons Community for lightning-fast advice, and a lot of helpful input to feed this pattern! Especially:
125123
* Johannes Tigges
126-
* Sebastian Spier
127-
* Maximilian Capraro
124+
* Sebastian Spier
125+
* Maximilian Capraro
128126
* Tim Yao

0 commit comments

Comments
 (0)