Skip to content

Commit 982167c

Browse files
spierspier
committed
Merge remote-tracking branch 'origin/main' into governance
2 parents 85002d5 + e21febc commit 982167c

27 files changed

+399
-398
lines changed

‎.github/CODEOWNERS

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
* @InnerSourceCommons/ispo-working-group-trusted-committers

‎.github/vale/Vocab/Base/accept.txt

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,16 @@
1+
omnichannel
2+
OSSWatch
3+
toolchain
4+
archivable
5+
6+
# people
7+
Jono
8+
Bacon
9+
Karl
10+
Fogel
11+
12+
# orgs
13+
Mattermost
14+
Atlasian
15+
Universidad
16+
Rey

‎.github/vale/Vocab/Base/reject.txt

Whitespace-only changes.

‎.github/workflows/vale.yml

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
name: Spelling & Styles
2+
3+
on:
4+
push:
5+
branches:
6+
- main
7+
paths:
8+
- '**.md'
9+
pull_request:
10+
branches:
11+
- main
12+
13+
jobs:
14+
vale:
15+
runs-on: ubuntu-latest
16+
17+
steps:
18+
- uses: actions/checkout@v3
19+
20+
- name: Vale Linting
21+
uses: errata-ai/vale-action@reviewdog
22+
with:
23+
files: '["introduction/", "infrastructure/", "measuring/"]'
24+
vale_flags: "--glob=*.md"
25+
filter_mode: added
26+
debug: true

‎.gitignore

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,2 @@
1+
# We want to ignore our vale StylesPath
2+
.github/vale/*

‎.vale.ini

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
StylesPath = .github/vale
2+
MinAlertLevel = suggestion
3+
4+
Packages = https://github.com/InnerSourceCommons/isc-styles/releases/latest/download/ISC.zip
5+
6+
Vocab = Base
7+
8+
[*]
9+
BasedOnStyles = ISC
10+
11+
; If you **don't** want to check for the correct spelling of "InnerSource", comment this in
12+
; ISC.InnerSource = NO

‎README.md

Lines changed: 15 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -16,15 +16,14 @@ You can find more information about the process in the [contributing section](ht
1616

1717
## Who is fostering this initiative?
1818

19-
Bitergia, as neutral actor in the software development analytics field aims at
20-
sharing the knowledge acquire during the last years. This book is currently focused on its main areas of expertise such as the usual metrics and KPI's to use,
19+
We thank [Bitergia] (especially José Manrique López and Daniel Izquierdo) for starting this book and seeding it with its main areas of expertise such as the usual metrics and KPI's to use,
2120
the methodology, the metrics strategy around your general InnerSource strategy
22-
or the infrastructure needed to have a successful InnerSource
23-
journey within your company.
21+
and the infrastructure needed to have a successful InnerSource
22+
journey within a company.
2423

25-
This book is open to anyone interested in InnerSource, either you are
26-
applying this and you want to share your use case or you have successfully
27-
applied InnerSource in your internal software development process.
24+
The book is now managed by the [ISPO Working Group].
25+
It is open for use and contribution by anyone interested in InnerSource.
26+
Come join us and contribute!
2827

2928
## How Do We Structure Goals, Questions, and Metrics?
3029

@@ -39,29 +38,21 @@ See the ["Metrics" section of CONTRIBUTING.md](./CONTRIBUTING.md#metrics).
3938

4039
## References
4140

42-
For further reading, we encourage you to participate in the [InnerSource Commons site](https://paypal.github.io/InnerSourceCommons/)
43-
funded by PayPal where dozens of companies are already sharing experiences and working to
44-
understand all of this. It is a great place to understand how others are facing this
45-
new methodology as we are all learning from this incipient process.
46-
47-
And finally, if you're interested in participating from a survey perspective and share
48-
your insights about this within your organization, please have a look at the
49-
[InnerSource Survey](https://paypal.github.io/InnerSourceCommons/assets/files/InnerSourceCommonsSurvey2016.pdf).
41+
For further reading, we encourage you to participate in the [InnerSource Commons],
42+
a non-profit foundation where dozens of companies are already sharing experiences and working to
43+
improve their craft of InnerSource.
5044

5145

5246
## Acknowledgements
5347

5448
Each chapter in the book is authored and reviewed by different people. That information can
55-
be found at the beginning of each chapter. This initiative is fostered by [Bitergia](https://bitergia.com)
56-
although given some technical issues, we finally decided to open this under a personal
57-
repository.
58-
59-
For further questions, please contact José Manrique López or Daniel Izquierdo:
60-
(jsmanrique|dizquierdo) at bitergia dot com.
61-
62-
63-
Thanks for your time here!
49+
be found at the beginning of each chapter. This initiative is fostered by the [ISPO Working Group].
50+
For further questions, please contact us in [Slack](https://innersourcecommons.org/slack)!
6451

6552
The book cover was created by [Sebastian Spier](https://spier.hu), using an image by user [Bru-nO](https://pixabay.com/photos/measure-unit-of-measure-meterstab-2737004/), available under the [Pixabay License](https://pixabay.com/service/license/).
6653

6754
All of the content found in this repository is licensed [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/).
55+
56+
[Bitergia]: https://bitergia.com/
57+
[ISPO Working Group]: https://innersourcecommons.org/community/#ispo
58+
[InnerSource Commons]: https://innersourcecommons.org/

‎SUMMARY.md

Lines changed: 7 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -6,34 +6,21 @@
66
* [Framework](introduction/framework.md)
77
* [Authors and Reviewers](introduction/authors.md)
88
* [Infrastructure](infrastructure/infrastructure.md)
9-
* [Basic Infrastructure](infrastructure/infrastructure.md#basic-infrastructure)
10-
* [Development Process](infrastructure/infrastructure.md#development-process-infrastructure)
11-
* [Communication Channels](infrastructure/infrastructure.md#communication-channels-infrastructure)
12-
* [Monitoring](infrastructure/infrastructure.md#monitoring-infrastructure)
13-
* [Comparing How Inner-Sourced Your Infra Is](infrastructure/infrastructure.md#comparing-how-inner-sourced-your-infrastructure-is)
9+
* [Basic Infrastructure](infrastructure/basics.md)
10+
* [Comparing How Inner-Sourced Your Infra Is](infrastructure/assessment.md)
1411
* [Authors and Reviewers](infrastructure/authors.md)
15-
* [What, When and How to Measure](measuring/introduction.md)
12+
* [What, When and How to Measure](measuring/measuring.md)
1613
* [Goals using Metrics](measuring/goals.md)
17-
* [Use Goals, Questions, and Metrics](measuring/use\_gqm.md)
18-
* [Goals](use\_gqm/goals/README.md)
14+
* [Use Goals, Questions, and Metrics](measuring/use_gqm.md)
15+
* [Goals](use_gqm/goals/README.md)
1916
* [Reduce Duplication](measuring/goals/reduce-duplication.md)
20-
* [Questions](use\_gqm/questions/README.md)
17+
* [Questions](use_gqm/questions/README.md)
2118
* [Who Uses](measuring/questions/who-uses.md)
22-
* [Metrics](use\_gqm/metrics/README.md)
19+
* [Metrics](use_gqm/metrics/README.md)
2320
* [Usage Count](measuring/metrics/usage-count.md)
2421
* [Areas of Analysis](measuring/areas.md)
2522
* [Goal-Question-Metric Approach](measuring/gqm.md)
2623
* [Strategy](measuring/strategy.md)
2724
* [Examples of Interest](measuring/metrics.md)
28-
* [Mentorship and helping Newcomers](measuring/metrics.md#mentorships-and-helping-newcomers)
29-
* [Development Cycle](measuring/metrics.md#development-cycle)
30-
* [Contributors Funnel](measuring/metrics.md#contributors-funnel)
31-
* [Engagement](measuring/metrics.md#engagement)
32-
* [Break Silos](measuring/metrics.md#break-silos)
33-
* [Spreading the Knowledge](measuring/metrics.md#spreading-the-knowledge)
34-
* [Middle Management Cultural Change](measuring/metrics.md#middle-management-cultural-change)
35-
* [Scalability](measuring/metrics.md#scalability)
36-
* [Keep great Developers in House](measuring/metrics.md#keep-great-developers-in-house)
37-
* [Allow Innovation in Detail](measuring/metrics.md#allow-innovation-in-detail)
3825
* [References](measuring/references.md)
3926
* [Authors and Reviewers](measuring/authors.md)

‎book.json

Lines changed: 0 additions & 25 deletions
This file was deleted.

‎infrastructure/assessment.md

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
# Comparing How InnerSourced your Infrastructure is
2+
3+
Just detailing the infrastructure needed within an organization to effectively
4+
apply InnerSource would be simplistic. This section aims at listing the
5+
questions you need to ask to your infrastructure team to check if
6+
that internal and well known infrastructure is able to be part of the
7+
InnerSource process.
8+
9+
The goal of this section is to compare the internal infrastructure used within
10+
an organization and check how close this is to an ideal InnerSource toolchain.
11+
As detail, in the software development process, it is necessary the use of
12+
specific tools such as the versioning system, code review process, ticketing
13+
system, continuous integration, documentation storage and collaborative
14+
platform to share technical decisions.
15+
16+
For each of those, we need to check if they are following the key aspects
17+
provided such as openness.
18+
19+
## Development Process Infrastructure
20+
21+
| | Openness | Transparency | Archivable | Searchable | Monitoring | Access Rights |
22+
|---------------------|----------|--------------|------------|------------|------------|---------------|
23+
| Versioning | | | | | | |
24+
| Ticketing system | | | | | | |
25+
| Code Review | | | | | | |
26+
| CI | | | | | | |
27+
| Wiki/Documentation | | | | | | |
28+
| TODO List | | | | | | |
29+
| Collaborative notes | | | | | | |
30+
31+
## Communication Channels Infrastructure
32+
33+
| | Openness | Transparency | Archivable | Searchable | Monitoring | Access Rights |
34+
|---------------------|----------|--------------|------------|------------|------------|---------------|
35+
| Mailing lists/forums| | | | | | |
36+
| Instant channels | | | | | | |
37+
| Questions/Answers | | | | | | |
38+
39+
## Monitoring Infrastructure
40+
41+
| | Openness | Transparency | Archivable | Searchable | Monitoring | Access Rights |
42+
|-------------------------|----------|--------------|------------|------------|------------|---------------|
43+
| Retrieval platform | | | | | | |
44+
| Enrichment platform | | | | | | |
45+
| Visualization platform | | | | | | |
46+
47+
# Some Examples of Infrastructure
48+
49+
GitHub enterprise.
50+
GitLab.
51+
In house repositories.
52+
Atlasian stack.

0 commit comments

Comments
 (0)