Skip to content

Commit 1016265

Browse files
committed
Restructure the Solution section
1 parent 14c7d23 commit 1016265

File tree

1 file changed

+28
-19
lines changed

1 file changed

+28
-19
lines changed

patterns/2-structured/governance-levels.md

Lines changed: 28 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -49,33 +49,38 @@ Agreement takes longer than expected because the "InnerSource" term did not desc
4949
## Solution
5050

5151
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.
5353

5454
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.
5555
Or in other terms, the level of influence a contributing team can gain in the respective project.
5656

57-
Examples of governance levels (more details below):
57+
Examples of governance levels:
5858

5959
- Bug Reports and Issues Welcome
6060
- Contributions Welcome
61+
- Shared Write Access
6162
- Shared Ownership
6263

63-
To evangelize these governance levels in your organization, follow these steps:
64+
To establish governance levels in your organization, we recommend these activities:
6465

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.
7568

76-
### Example: Commonly used Governance Levels
69+
We will go into more detail on each of these activities in the following sections.
7770

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.
7984

8085
Each of these levels adds more influence/karma to the contributing team.
8186
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
107112
<figure><img src="../../assets/img/governance-levels/4.png" alt="Shared Ownership"><figcaption><p>Shared Ownership</p></figcaption></figure>
108113
</div>
109114

110-
### 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.
111118

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)).
113122
- 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.
116125

117126
## Resulting Context
118127

0 commit comments

Comments
 (0)