Skip to content

Commit 2402f05

Browse files
MaineCspier
andauthored
Adds a pattern draft for making governance levels explicit. (#281)
Adds a pattern draft for making governance levels explicit. This adds a pattern for making several levels of openess wrt. governance levels explicit to project contributors. Inspired by several versions of Open Source project governance (e.g. single vendor with full control, foundation hosted with vendor neutrality as a goal etc.) this pattern tries to translate these versions into an InnerSource context. Co-authored-by: Sebastian Spier <[email protected]>
1 parent 64ae1ac commit 2402f05

File tree

2 files changed

+73
-0
lines changed

2 files changed

+73
-0
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -76,6 +76,7 @@ The below lists all known patterns. They are grouped into three [maturity levels
7676
* [Reluctance to Receive Contributions](patterns/1-initial/reluctance-to-accept-contributions.md) - *Core owner of shared asset is reluctant to take contributions due to the required maintenance that comes with them. Summary pattern that lays out four children patterns with three to be defined.*
7777
* [Include Product Owners](patterns/1-initial/include-product-owners.md) - *Engaging and educating Product Owners about InnerSource can help them modify their actions (e.g., in the space of KPIs) to help InnerSource collaboration work better.*
7878
* [Assisted Compliance](patterns/1-initial/assisted_compliance.md) - *Helping repo owners be compliant by writing their CONTRIBUTING.md for them as a pull request.*
79+
* [Transparent Governance Levels](patterns/1-initial/governance-levels.md) - *There are projects in multiple stages of InnerSource adoption. Contributors get confused when working with projects that are at different stages.*
7980

8081
#### Donuts (needing a solution)
8182

Lines changed: 72 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,72 @@
1+
## Title
2+
3+
Transparent Governance Levels
4+
5+
## Context
6+
7+
Several teams are using InnerSource patterns and best practices. However the
8+
degree to which they welcome not only contributions but give equal collaboration
9+
rights to contributors differ. As a result there are unmatched expectations,
10+
confusion and frustration when teams collaborate across team boundaries.
11+
12+
## Problem
13+
14+
For two projects InnerSource best practices have been adopted. Project A
15+
has a shared ownership model with [Trusted Committers](../2-structured/trusted-committer.md) from multiple teams.
16+
Project B is fully owned by one team, only contributions are coming from
17+
multiple teams. New contributors to either project are regularly confused about
18+
the level of influence they can gain to the respective project. This leads to
19+
long discussions, escalations and time lost on clarifications.
20+
21+
## Forces
22+
23+
- For project A shared ownership works well, members coming from multiple teams
24+
are working together.
25+
- For project B the backing team would like to retain a certain level of
26+
ownership and control. Sharing ownership with other Trusted Committers outside
27+
of the original team is not an option.
28+
- Contributors want clarity on the level of influence they can gain in an
29+
InnerSource project they are involved with.
30+
- Writing detailed guidelines into each contributions file leads to a lot of
31+
text that is hard to understand for engineers.
32+
33+
## Solution
34+
35+
Establish standardised building blocks which can be used by projects to signify
36+
how much influence they are willing to share. Those building blocks can then be
37+
used in contributing files.
38+
39+
Examples of building blocks:
40+
41+
* **Bug reports and issues welcome**: People outside the core development team are
42+
welcome to read the code. They can submit feature requests and bug reports for
43+
things they would like to see changed.
44+
45+
* **Contributions welcome**: People outside the core development team may use the
46+
code, make modifications and feed those modifications back into the projects.
47+
Trusted committers are willing to mentor those contributions to a state where
48+
they can be accepted or communicate clearly why the proposed change cannot be
49+
made.
50+
51+
* **Shared write access**: In addition to the above people outside the core
52+
development team may gain write access to the source repository. Influence on
53+
roadmap decisions as well as influence on who else gains write access is
54+
restricted to the core development team.
55+
56+
* **Shared ownership**: Members of different teams collaborate on the project as
57+
equal peers. Everyone has the ability to merge code. Everyone has an equal say
58+
on the project direction. Everyone has an equal say in who else to add to this
59+
group.
60+
61+
## Resulting Context
62+
63+
Teams can adopt InnerSource best practices in a step-by-step way. By documenting
64+
individual steps contributor confusion is avoided.
65+
66+
## Known Instances
67+
68+
TBD
69+
70+
## Status
71+
72+
Initial (Early draft)

0 commit comments

Comments
 (0)