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
+28-19Lines changed: 28 additions & 19 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -49,33 +49,38 @@ Agreement takes longer than expected because the "InnerSource" term did not desc
49
49
## Solution
50
50
51
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 but feel free to use whatever terms fits your organization best.
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
53
54
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.
55
55
Or in other terms, the level of influence a contributing team can gain in the respective project.
56
56
57
-
Examples of governance levels (more details below):
57
+
Examples of governance levels:
58
58
59
59
- Bug Reports and Issues Welcome
60
60
- Contributions Welcome
61
+
- Shared Write Access
61
62
- Shared Ownership
62
63
63
-
To evangelize these governance levels in your organization, follow these steps:
64
+
To establish governance levels in your organization, we recommend these activities:
64
65
65
-
1. Define your governance levels
66
-
- Document the governance levels that are commonly used in your organization.
67
-
- Document additional governance levels that you don't have yet, but that would benefit the cross-team collaboration in your organization.
68
-
- Give each of them a distinctive and descriptive name.
69
-
- Use specific projects as examples where helpful.
70
-
-**Goal**: Have a clear written description of the governance levels, that you can refer to as a reference.
71
-
2. Promote your governance levels
72
-
- Present your governance levels in existing knowledge sharing forums in your organization.
73
-
- Stick to the names of these governance levels that you chose above.
74
-
-**Goal**: The governance levels are known and understood throughout your organization.
66
+
1. Define your governance levels - **Goal**: Have a clear written description of the governance levels, that you can refer to as a reference.
67
+
2. Promote your governance levels - **Goal**: The governance levels are known and understood throughout your organization.
75
68
76
-
### Example: Commonly used Governance Levels
69
+
We will go into more detail on each of these activities in the following sections.
77
70
78
-
These are governance levels that are commonly used when practicing InnerSource.
71
+
### Define your Governance Levels
72
+
73
+
The goal of this activity is to have a clear written description of the governance levels, that you can refer to as a reference.
74
+
75
+
- Document the governance levels that are commonly used in your organization.
76
+
- Document additional governance levels that you don't have yet, but that would benefit the cross-team collaboration in your organization.
77
+
- Give each of them a distinctive and descriptive name.
78
+
- Use specific projects as examples where helpful.
79
+
- Keep this documentation in a central place that you can easily reference that can be accessed by everybody.
80
+
81
+
#### Commonly used Governance Levels
82
+
83
+
The following governance levels are commonly used when practicing InnerSource.
79
84
80
85
Each of these levels adds more influence/karma to the contributing team.
81
86
However each step also requires more transparency and shared communication resources between both teams.
@@ -107,12 +112,16 @@ However each step also requires more transparency and shared communication resou
### Example: Different Ways of Promoting the Governance Levels
115
+
### Promote your Governance Levels
116
+
117
+
The goal of this activity is that the governance levels are known and understood throughout your organization, and that some of your higher profile InnerSource project start to adopt these governance levels explicitly.
111
118
112
-
- Use the chosen names of your governance levels within project documentation and contributing guides (see also [Standard Base Documentation](../2-structured/base-documentation.md)).
119
+
- Present your governance levels in existing knowledge sharing forums in your organization. Make sure to explain the why, not just the what!
120
+
- Whenever talking about your governance levels, make sure to stick to he exact names/titles of your governance levels.
121
+
- Use the names of your governance levels within project documentation and contributing guides (see also [Standard Base Documentation](../2-structured/base-documentation.md)).
113
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.
114
-
- Create training material contain examples of projects in your organization, that make it easier for people in your organization what these governance levels mean and how they work.
115
-
-Presenting the governance levels as a menu of adoption options when launching new InnerSource projects.
123
+
- 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
+
-Present the governance levels as a menu of adoption options when launching new InnerSource projects.
0 commit comments