You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: patterns/2-structured/governance-levels.md
+18-12Lines changed: 18 additions & 12 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,7 +4,7 @@ Project Governance Levels
4
4
5
5
## Patlet
6
6
7
-
Several teams are using different InnerSource patterns and all calling it "InnerSource", so the term is not precise enough to usefully describe a set of working practices without confusion.
7
+
Several teams are using different InnerSource patterns and all calling it "InnerSource", so the term is not precise enough to describe a set of working practices without confusion.
8
8
Establishing a more accurate common language that is understood across all teams allows anyone to communicate intent or set expectations efficiently without ambiguity.
9
9
10
10
## Problem
@@ -48,12 +48,14 @@ Agreement takes longer than expected because the "InnerSource" term did not desc
48
48
49
49
## Solution
50
50
51
-
Create a universally understood language to describe the project governance levels that are used in your organization.
52
-
Note: These governance levels may also be referred to as "operating models", or "ownership models". We stick to the term "governance levels" throughout this pattern. Feel free to use whatever terms fits your organization best.
53
-
54
-
We define **governance levels** as a description of how much influence the core development team of a project is willing to share with contributing teams.
51
+
Create centrally maintained documentation of the project governance levels that are used in your organization.
52
+
The governance levels describe how much influence the host team of a project is willing to share with contributing teams.
55
53
Or in other terms, the level of influence a contributing team can gain in the respective project.
56
54
55
+
Note: Instead of "governance levels" we might also say "operating models", or "ownership models".
56
+
We stick to the term "governance levels" throughout this pattern.
57
+
Feel free to use whatever terms fits your organization best.
58
+
57
59
Examples of governance levels:
58
60
59
61
- Bug Reports and Issues Welcome
@@ -86,19 +88,19 @@ Each of these levels adds more influence/karma to the contributing team.
86
88
However each step also requires more transparency and shared communication resources between both teams.
87
89
88
90
1.**Bug Reports and Issues Welcome**:
89
-
- People outside the core development team may use the code.
91
+
- People outside the host team may use the code.
90
92
- They can submit feature requests and bug reports for things they would like to see changed.
91
93
- aka **Readable Source**, **Shared Source**
92
94
2.**Contributions Welcome**:
93
-
- People outside the core development team may use the code.
94
-
- They can also make modifications and submit them to the core team for inclusion.
95
+
- People outside the host team may use the code.
96
+
- They can make modifications and submit them to the host team for inclusion.
95
97
- aka **Guest Contributions**
96
98
3.**Shared Write Access**:
97
-
- People outside of the core development team can get write access to the project.
98
-
- The core development team may decide to give these outside contributors additional leverage in the strategic direction of the project
99
+
- People outside of the host team can get write access to the project.
100
+
- The host team may give outside contributors additional leverage in the strategic direction of the project.
99
101
- Related Pattern: [Trusted Committer](../2-structured/trusted-committer.md)
100
102
4.**Shared Ownership**:
101
-
- Members of different teams (or even the entire teams) collaborate on the project as equal peers.
103
+
- Members of different teams collaborate on the project as equal peers.
102
104
- Everyone has the ability to merge code.
103
105
- Everyone has an equal say on the project direction.
104
106
- Everyone has an equal say in who else to add to this group.
@@ -119,7 +121,7 @@ The goal of this activity is that the governance levels are known and understood
119
121
- Present your governance levels in existing knowledge sharing forums in your organization. Make sure to explain the why, not just the what!
120
122
- Whenever talking about your governance levels, make sure to stick to he exact names/titles of your governance levels.
121
123
- Use the names of your governance levels within project documentation and contributing guides (see also [Standard Base Documentation](../2-structured/base-documentation.md)).
122
-
- Label projects with the governance levels in an [InnerSource Portal](../2-structured/innersource-portal.md), so that contributors can see at a glance what type of InnerSource collaboration the core team currently supports.
124
+
- Label projects with the governance levels in an [InnerSource Portal](../2-structured/innersource-portal.md), so that contributors can see at a glance what type of InnerSource collaboration the host team supports for the given project.
123
125
- Create training material containing examples of projects in your organization. That makes it easier for people in your organization to related to these examples and understand what these governance levels mean and how they work.
124
126
- Present the governance levels as a menu of adoption options when launching new InnerSource projects.
0 commit comments