Skip to content

Promoting Governance Levels pattern to Structured #765

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 49 commits into from
Mar 15, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
49 commits
Select commit Hold shift + click to select a range
3f40799
Promoting the pattern to Structured. Adding checklist to PR to confir…
spier Jan 24, 2025
6aaac81
Update README entry for this pattern
spier Jan 25, 2025
36885f9
Adding terminology to the open source analogies
spier Jan 25, 2025
9edb239
Splitting up the different rights that the people get in each of the …
spier Jan 25, 2025
2cb3b25
Suggesting a new name
spier Jan 25, 2025
a32e20d
Fix linter issues
spier Jan 25, 2025
c451302
Fix link in README
spier Jan 26, 2025
c7e970e
Fix link for good :)
spier Jan 26, 2025
6ad7473
Adding alternative names for each stage
spier Jan 26, 2025
0785773
Adding subsections in the Solution
spier Jan 26, 2025
108d3f2
Adding new visual from Flutter, just to see how it would look like in…
spier Jan 26, 2025
07eb806
Simplify the text
spier Jan 26, 2025
43f3f38
Adding Alias section
spier Jan 28, 2025
32181b8
Fix linter issue
spier Jan 28, 2025
76ca3c7
Adding Tom Sadler to the authors
spier Jan 28, 2025
b76c6b0
Adding pattern to the mindmap (can be added in added in other areas a…
spier Jan 28, 2025
28b3538
Adding Europace as a known instance
spier Jan 28, 2025
24d6988
Re-creating markmap and screenshot
spier Jan 28, 2025
09abdeb
Typo fixes. Using US-english.
spier Feb 18, 2025
7aef3ba
Rename Story section. Using new visual from Flutter.
spier Feb 18, 2025
2cda6f0
Adding image
spier Feb 18, 2025
fbbff7f
New link
spier Feb 18, 2025
f8a64a4
Use the term 'governance levels' consistently throughout the pattern.…
spier Mar 2, 2025
6f5a484
Moving the description of how this pattern relates to open source to …
spier Mar 2, 2025
ed225f9
Adding 'Shared Write Access' as 4th governance level again. Adding im…
spier Mar 2, 2025
701a964
Merge branch 'main' into promote-governance-levels
spier Mar 2, 2025
e2bcebf
Fixing commonmarker version
spier Mar 2, 2025
fbacf42
Update toc
spier Mar 2, 2025
fa48e78
Adding some intro text, and numbers to the 4 levels
spier Mar 2, 2025
299ac5d
Try an image gallery
spier Mar 2, 2025
3a31972
Cleanup duplicated images
spier Mar 2, 2025
14c7d23
Seems like a fair addition ;)
spier Mar 3, 2025
1016265
Restructure the Solution section
spier Mar 3, 2025
f12b927
Use 'host team' intead of 'core development team' to prevent confusio…
spier Mar 6, 2025
7782d8f
Trying a new Patlet, partly suggested by chatgpt
spier Mar 6, 2025
1b42b80
Trying a new title to see if it sticks
spier Mar 6, 2025
d5df06f
Updating toc
spier Mar 6, 2025
f21cc48
Remove this sections, as the commonly used levels are listed shortly …
spier Mar 6, 2025
e830e89
Move flutter image into the right folder. delete old files
spier Mar 6, 2025
ea91dbd
Fix link
spier Mar 6, 2025
63f31e6
Add pattern to other areas in the mindmap
spier Mar 6, 2025
7c5dfee
Change title
spier Mar 6, 2025
2b10aaa
Fix description in README
spier Mar 6, 2025
4503eb9
Minor fix for from BE to AE. Some markdown fixes.
spier Mar 15, 2025
346f184
Update Aliases
spier Mar 15, 2025
ebdc9f9
Try a different pattern name. keeping the file name the same to allow…
spier Mar 15, 2025
5eb9f7e
Regenerate TOC
spier Mar 15, 2025
378b41c
Stick to the 'Explicit Governance Levels' titel after all
spier Mar 15, 2025
1ec2e25
Merge branch 'main' into promote-governance-levels
spier Mar 15, 2025
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
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,6 +58,7 @@ Our mission
* [Extensions for Sustainable Growth](/patterns/2-structured/extensions-for-sustainable-growth.md) - *An InnerSource project is receiving too many contributions, making maintenance difficult. By offering an extension mechanism outside of the core project, the maintainers enable scaling of project capabilities with minimal cost and maintenance overhead.*
* [Standard Release Process](patterns/2-structured/release-process.md) - *Teams may hesitate to adopt an InnerSource project if they are unsure of its maturity. To address this, consistent release notes and published artifacts are crucial. These practices showcase a strong dedication to the project, instilling confidence and assuring users of ongoing commitment to sustainable and well-managed software.*
* [Group Support](patterns/2-structured/group-support.md) - *What happens if a team or individual no longer supports an InnerSource project? Keep the project alive by forming a group of interested individuals.*
* [Explicit Governance Levels](patterns/2-structured/governance-levels.md) - *Different teams within an organization use InnerSource practices in varying ways, leading to confusion and inefficiencies due to inconsistent expectations of collaboration and contribution rights. Establish centrally documented governance levels that define the extent of influence contributing teams can have on a project, improving clarity for contributors and host teams alike.*

### Maturity Level 1: Initial

Expand All @@ -71,7 +72,6 @@ Our mission
* [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.*
* [Assisted Compliance](patterns/1-initial/assisted_compliance.md) - *Helping repo owners be compliant by writing their CONTRIBUTING.md for them as a pull request.*
* [Open Source Trumps InnerSource](patterns/1-initial/open-source-trumps-innersource.md) - *Developers disregard InnerSource projects because they consider open source projects to be superior. Introducing a required evaluation of InnerSource projects before choosing an open source project increases the likelihood of the InnerSource projects to be adopted.*
* [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.*
* [Governance Level Guided Project Setup](/patterns/1-initial/governance-based-project-setup.md) - *Before publishing their first InnerSource project, a team wants to choose an appropriate Governance Level but is unsure about the impact of the different levels on their daily doing. A dedicated list of resources (best practices, recommended patterns, target maturity levels) provides specific guidance to the team and helps them to make an educated decision.*
* [Contained InnerSource](patterns/1-initial/contained-innersource.md) - *Apply InnerSource methods to facilitate collaboration in a cross-divisional project but don't invest in soliciting contributions from outside of that project.*
* [Good First Project](patterns/1-initial/good-first-project.md) - *An InnerSource program has been launched at an organization, and to get off to a successful start it requires some good first projects that lend themselves to InnerSource-style development. Assessing the InnerSource-readiness (fitness) of the candidate projects can help in selecting projects that have the potential to help demonstrate the power of InnerSource.*
Expand Down
3 changes: 0 additions & 3 deletions assets/img/flutter-pyramid.svg

This file was deleted.

Binary file added assets/img/governance-levels/1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/governance-levels/2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/governance-levels/3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/img/governance-levels/4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions book/en/toc.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ Instead edit toc_template.md
* [Cross-Team Project Valuation](../../patterns/2-structured/crossteam-project-valuation.md) - It's hard to sell the value of cross-team InnerSource projects that don't provide a direct impact on company revenue. Here's a data-driven way to represent your project that both articulates its value and amplifies it.
* [Dedicated Community Leader](../../patterns/2-structured/dedicated-community-leader.md) - Select people with both communications and technical skills to lead the communities to ensure success in starting an InnerSource initiative.
* [Document your Guiding Principles](../../patterns/2-structured/document-your-guiding-principles.md) - The usual InnerSource explanation of "applying open source best practices inside an organization" does not work well with people lacking an open source background. As a remedy the most important principles of InnerSource get documented and published widely.
* [Explicit Governance Levels](../../patterns/2-structured/governance-levels.md) - Different teams within an organization use InnerSource practices in varying ways, leading to confusion and inefficiencies due to inconsistent expectations of collaboration and contribution rights. Establish centrally documented governance levels that define the extent of influence contributing teams can have on a project, improving clarity for contributors and host teams alike.
* [Extensions for Sustainable Growth](../../patterns/2-structured/extensions-for-sustainable-growth.md) - An InnerSource project is receiving too many contributions, making maintenance difficult. By offering an extension mechanism outside of the core project, the maintainers enable scaling of project capabilities with minimal cost and maintenance overhead.
* [Gig Marketplace](../../patterns/2-structured/gig-marketplace.md) - Establish a marketplace by creating an intranet website that lists specific InnerSource project needs as "Gigs" with explicit time and skill requirements. This will enable managers to better understand their employee’s time commitment and professional benefits thereby increasing the likelihood of garnering approval to make InnerSource contributions.
* [Group Support](../../patterns/2-structured/group-support.md) - What happens if a team or individual no longer supports an InnerSource project? Keep the project alive by forming a group of interested individuals.
Expand Down
2 changes: 1 addition & 1 deletion book/scripts/Gemfile
Original file line number Diff line number Diff line change
Expand Up @@ -4,4 +4,4 @@ source "https://rubygems.org"

git_source(:github) {|repo_name| "https://github.com/#{repo_name}" }

gem 'commonmarker'
gem 'commonmarker', "0.18.2"
2 changes: 1 addition & 1 deletion pattern-categorization/innersource-program-mind-map.html

Large diffs are not rendered by default.

8 changes: 8 additions & 0 deletions pattern-categorization/innersource-program-mind-map.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,6 +30,10 @@

##### [Issue Tracker Use Cases](https://patterns.innersourcecommons.org/p/issue-tracker)

#### Language around project governance is ambiguous

##### [Explicit Governance Levels](https://patterns.innersourcecommons.org/p/governance-levels)

## Adopt

### Valuation Challenges
Expand Down Expand Up @@ -92,6 +96,10 @@

##### [Transparent Cross-Team Decision Making using RFCs](https://patterns.innersourcecommons.org/p/transparent-cross-team-decision-making-using-rfcs)

#### Level of influence for contributing teams is unclear

##### [Explicit Governance Levels](https://patterns.innersourcecommons.org/p/governance-levels)

#### Project without an owner/maintainer

##### [Core Team](https://patterns.innersourcecommons.org/p/core-team)
Expand Down
Binary file modified pattern-categorization/innersource-program-mind-map.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
100 changes: 0 additions & 100 deletions patterns/1-initial/governance-levels.md

This file was deleted.

Loading
Loading