Skip to content
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,7 @@ The below lists all known patterns. They are grouped into three [maturity levels
* [What Before How or Services Documentation](https://docs.google.com/document/d/1_N1wsQeDusfIcNy-O2ZXenY3PL7ZbvkUDRZxGUuegZw/edit?usp=drive_web) - *A lack of common understanding between different management tiers creates funding barriers and increases the risk that solutions will not deliver required business outcomes.*
* [Open Source Trumps InnerSource](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/46) - *People find the InnerSource project but, after all things are considered, even if the InnerSource component meets their needs, they still go with the open source component.*
* [Include Product Owners](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/71) - *Key Performance Indicators (KPIs) for Product Owners are primarily product focused, and don't consider areas such as collaborative development. This results in a lower level of engagement with inner source projects.*
* [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.*

### Maturity Level 1: Initial

Expand Down
76 changes: 76 additions & 0 deletions patterns/1-initial/governance-levels.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,76 @@
## Title

Transparent governance levels

## Context

Several teams are using InnerSource patterns and best practices. However the
degree to which they welcome not only contributions but give equal collaboration
rights to contributors differ. As a result there are unmatched expectations,
confusion and frustration when teams collaborate across team boundaries.

## Problem

For two projects InnerSource best practices have been adopted. Project A
has a shared ownership model with Trusted Committers from multiple teams.
Project B is fully owned by one team, only contributions are coming from
multiple teams. New contributors to either project are regularly confused about
the level of influence they can gain to the respective project. This leads to
long discussions, escalations and time lost on clarifications.

## Forces

- For project A shared ownership works well, members coming from multiple teams
are working together.
- For project B the backing team would like to retain a certain level of
ownership and control. Sharing ownership with other Trusted Committers outside
of the original team is not an option.
- Contributors want clarity on the level of influence they can gain in an
InnerSource project they are involved with.
- Writing detailed guidelines into each contributions file leads to a lot of
text that is hard to understand for engineers.


## Solution

Establish standardised building blocks which can be used by projects to signify
how much influence they are willing to share. Those building blocks can then be
used in contributing files.

Examples of building blocks:

* Bug reports and issues welcome: People outside the core development team are
welcome to read the code. They can submit feature requests and bug reports for
things they would like to see changed.

* Contributions welcome: People outside the core development team may use the
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is "core development team" here the same as "backing team" which you used above?

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think I'm lacking a good term here: What I'm trying to explain is that there is a difference between a project that is carried forward by individuals working under one line manager, delivering one roadmap vs. a project where individuals from multiple such teams collaborate.

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I see. I don't know the best term here either.
For the time being I would then suggest to just introduce and define a term, likely towards the beginning of the Pattern, and then stick to that term through out the pattern.

As we improve this pattern over time we might come up with another term, possibly influenced by other patterns as well. We may even want to pull such terms that we attribute certain meaning to into a central glossary to help pattern authors and readers to use these terms in a similar manner.

code, make modifications and feed those modifications back into the projects.
Trusted committers are willing to mentor those contributions to a state where
they can be accepted or communicate clearly why the proposed change cannot be
made.

* Shared write access: In addition to the above people outside the core
development team may gain write access to the source repository. Influence on
roadmap decisions as well as influence on who else gains write access is
restricted to the core development team.

* Shared ownership: Members of different teams collaborate on the project as
equal peers. Everyone has the ability to merge code. Everyone has an equal say
on the project direction. Everyone has an equal say in who else to add to this
group.


## Resulting Context

Teams can adopt InnerSource best practices in a step-by-step way. By documenting
individual steps contributor confusion is avoided.

## Known Instances

TBD

## Status

Early draft