From 8c8928ca5fec5252e6b35761a2aeff30daa60ba0 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 18:13:05 +0100 Subject: [PATCH 1/8] Formatting Forces as list, to allow for easier checking --- patterns/2-structured/maturity-model.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index e9ce8c070..252e004b6 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -30,13 +30,9 @@ InnerSource project differs depending on each team. ## Forces -Teams sharing InnerSource learnings run into misunderstandings as they are not -aware of their respective level of InnerSource adoption. - -Teams believe that "it's all about migrating to a shared software development -[forge](https://en.wikipedia.org/wiki/Forge_%28software%29)" (GitLab, GitHub, or Bitbucket being well known examples of such forges). - -Teams are not aware of best practices that would help them solve issues that +* Teams sharing InnerSource learnings run into misunderstandings as they are not aware of their respective level of InnerSource adoption. +* Teams believe that "it's all about migrating to a shared software development [forge](https://en.wikipedia.org/wiki/Forge_%28software%29)" (GitLab, GitHub, or Bitbucket being well known examples of such forges). +* Teams are not aware of best practices that would help them solve issues that they run into in their daily doing. ## Solution From 3b601c87a7111d8b0fc61ec5abf2b147e1bdb5cc Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 18:15:25 +0100 Subject: [PATCH 2/8] Formatting Context as list, to allow for easier checking --- patterns/2-structured/maturity-model.md | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index 252e004b6..3be0fb4ee 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -22,11 +22,10 @@ pain points that they are dealing with. ## Context -Several teams have started adopting InnerSource practices. The exact level of -understanding of the practice diverges between teams. The exact problems teams -run into diverge depending on the context and working environment of each team. -As a result the definition of what are important best practices in an -InnerSource project differs depending on each team. +* Several teams have started adopting InnerSource practices. +* The exact level of understanding of the practice diverges between teams. +* The exact problems teams run into diverge depending on the context and working environment of each team. +* As a result the definition of what are important best practices in an InnerSource project differs depending on each team. ## Forces From bfc29c4657dbd0b5674c6492c80553341b6c0861 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 18:22:49 +0100 Subject: [PATCH 3/8] Format list correctly (to prevent issues in gitbook) --- patterns/2-structured/maturity-model.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index 3be0fb4ee..5e56b0d85 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -31,8 +31,7 @@ pain points that they are dealing with. * Teams sharing InnerSource learnings run into misunderstandings as they are not aware of their respective level of InnerSource adoption. * Teams believe that "it's all about migrating to a shared software development [forge](https://en.wikipedia.org/wiki/Forge_%28software%29)" (GitLab, GitHub, or Bitbucket being well known examples of such forges). -* Teams are not aware of best practices that would help them solve issues that -they run into in their daily doing. +* Teams are not aware of best practices that would help them solve issues that they run into in their daily doing. ## Solution From 7d18d5436e31ac4c37105abcdc823d8aaaa6dc7f Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 20:02:57 +0100 Subject: [PATCH 4/8] rewrite Patlet into the 2 sentence form (1 problem + 1 solution) --- patterns/2-structured/maturity-model.md | 7 ++----- 1 file changed, 2 insertions(+), 5 deletions(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index 5e56b0d85..ace8148c6 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -4,11 +4,8 @@ Maturity Model ## Patlet -Teams have started adopting InnerSource. The practice is spreading to multiple -departments. However, the understanding of what constitutes an InnerSource -project varies. The solution is to provide a maturity model to allow for teams -to go through a self check and discover patterns and practices that they are not -yet aware of. +The InnerSource practices are spreading to multiple teams and departments, however the understanding of what constitutes an InnerSource project varies. +Defining a maturity model enablesq teams to do a self-assessment and discover patterns and practices that they are not yet aware of. ## Problem From 5a0763ded300d077043de229169c6121012a198e Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 20:23:03 +0100 Subject: [PATCH 5/8] Generalize the Solution section. Separate the definition of the maturity model from the self-assessment of the teams. --- patterns/2-structured/maturity-model.md | 19 ++++++++++++++++++- 1 file changed, 18 insertions(+), 1 deletion(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index ace8148c6..53d9a33db 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -32,7 +32,24 @@ pain points that they are dealing with. ## Solution -Ask teams to self assess against the proposed maturity model. +For this pattern in particular it is important to note that adopters of this pattern will likely not use the maturity modal proposed here as is! +The context of most organization will differ to greatly to do that. +Hence you may take the proposed maturity model as a starting point if you like, but it is key that you adapt it to the needs and goals of your orgnization! + +Steps to implement: + +1. **maturity mode definition**: Create a maturity model that fits the needs of your organization. Also consider the [Guiding Principles](../2-structured/document-your-guiding-principles.md) if you have defined those for your InnerSource program. +2. **team self-assessment**: Then ask teams to self-assess against that maturity model. You may even do a couple of these sessions together with a view teams, to observe and learn if the maturity model is easy enough to understand. +3. ... + +Note that the path is part of the goal in multiple ways here: + +* Defining your own maturity model allows you, the organizers of the InnerSource program, to increase your own clarity. e.g. you will realize what matters to you, what training capabilities you have internally, what material is available externally, etc +* You increase the trust in your initiative by allowing teams to go through the self-assessment at their own pace, and by opening up to feedback from them. +* The teams going through the self-assessment will likely have discussions, possibly even disagreements about some of the points in the Maturity Model. That is fantastic as it offers a great starting point for relevant discussions to increase their shared understanding of InnerSource. + +Below we have defined a sample maturity model around 4 categories (Transparency, Collaboration, Community, Governance). +Make sure you adapt this model to fit your organization! ### Transparency From 8a3daef22758ee0575333079eaa4f0fb55ae49d2 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 20:23:30 +0100 Subject: [PATCH 6/8] Adding myself as author --- patterns/2-structured/maturity-model.md | 1 + 1 file changed, 1 insertion(+) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index 53d9a33db..b772583c6 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -228,6 +228,7 @@ long term. * Isabel Drost-Fromm * Jorge * Nerea +* Sebastian Spier ## Acknowledgements From 8f8bfa2288a54c2ca18140e36d66f57a6e057120 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 20:24:45 +0100 Subject: [PATCH 7/8] Formatting Resulting Context as list, to allow for easier checking --- patterns/2-structured/maturity-model.md | 10 +++------- 1 file changed, 3 insertions(+), 7 deletions(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index b772583c6..11d85e948 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -208,13 +208,9 @@ InnerSource comes with explicit roles. While in early stages some patterns may b ## Resulting Context -All teams are aware of available best practices. - -Teams understand their level of InnerSource adoption. - -Prior to adopting InnerSource as a working model, teams are aware of the -practices that are expected of them - both in the short term and in the -long term. +* All teams are aware of available best practices. +* Teams understand their level of InnerSource adoption. +* Prior to adopting InnerSource as a working model, teams are aware of the practices that are expected of them - both in the short term and in the long term. ## Known Instances From b5fbcaed05279eb339e9130f231d4e50222127ad Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Thu, 23 Mar 2023 20:40:47 +0100 Subject: [PATCH 8/8] Fix spelling Co-authored-by: rrrutledge --- patterns/2-structured/maturity-model.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/2-structured/maturity-model.md b/patterns/2-structured/maturity-model.md index 11d85e948..9e981a75a 100644 --- a/patterns/2-structured/maturity-model.md +++ b/patterns/2-structured/maturity-model.md @@ -5,7 +5,7 @@ Maturity Model ## Patlet The InnerSource practices are spreading to multiple teams and departments, however the understanding of what constitutes an InnerSource project varies. -Defining a maturity model enablesq teams to do a self-assessment and discover patterns and practices that they are not yet aware of. +Defining a maturity model enables teams to do a self-assessment and discover patterns and practices that they are not yet aware of. ## Problem