From a79bb12381732de8a397cf13100ac6e44bf30885 Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Fri, 28 Feb 2025 07:25:58 -0800 Subject: [PATCH 1/4] feat: promote source-code-inventory --- patterns/1-initial/source-code-inventory.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/1-initial/source-code-inventory.md b/patterns/1-initial/source-code-inventory.md index 71bca0563..a29765de3 100644 --- a/patterns/1-initial/source-code-inventory.md +++ b/patterns/1-initial/source-code-inventory.md @@ -100,7 +100,7 @@ The Source Code Strategy Assessment Framework helps teams to understand the valu ## Status -* Initial +* Structured ## Author(s) From 1b78d7e0e5abf7c9a7b6647f3b2f14ccee0ec4d1 Mon Sep 17 00:00:00 2001 From: Jeff Bailey <776901+jeffabailey@users.noreply.github.com> Date: Fri, 28 Feb 2025 07:42:58 -0800 Subject: [PATCH 2/4] chore: move to structured dir --- patterns/{1-initial => 2-structured}/source-code-inventory.md | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename patterns/{1-initial => 2-structured}/source-code-inventory.md (100%) diff --git a/patterns/1-initial/source-code-inventory.md b/patterns/2-structured/source-code-inventory.md similarity index 100% rename from patterns/1-initial/source-code-inventory.md rename to patterns/2-structured/source-code-inventory.md From 8b90a187db7cec1427c1f618cf981df701d58510 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sun, 13 Apr 2025 20:19:00 +0200 Subject: [PATCH 3/4] Move images to subfolder. Lowercase file extension. --- .../source-code-inventory-mockup-dashboard.png} | Bin .../source-code-inventory-mockup-questionnaire.png} | Bin patterns/2-structured/source-code-inventory.md | 2 +- 3 files changed, 1 insertion(+), 1 deletion(-) rename assets/img/{source-code-inventory-mockup-dashboard.PNG => source-code-inventory/source-code-inventory-mockup-dashboard.png} (100%) rename assets/img/{source-code-inventory-mockup-questionnaire.PNG => source-code-inventory/source-code-inventory-mockup-questionnaire.png} (100%) diff --git a/assets/img/source-code-inventory-mockup-dashboard.PNG b/assets/img/source-code-inventory/source-code-inventory-mockup-dashboard.png similarity index 100% rename from assets/img/source-code-inventory-mockup-dashboard.PNG rename to assets/img/source-code-inventory/source-code-inventory-mockup-dashboard.png diff --git a/assets/img/source-code-inventory-mockup-questionnaire.PNG b/assets/img/source-code-inventory/source-code-inventory-mockup-questionnaire.png similarity index 100% rename from assets/img/source-code-inventory-mockup-questionnaire.PNG rename to assets/img/source-code-inventory/source-code-inventory-mockup-questionnaire.png diff --git a/patterns/2-structured/source-code-inventory.md b/patterns/2-structured/source-code-inventory.md index a29765de3..723c6f2d3 100644 --- a/patterns/2-structured/source-code-inventory.md +++ b/patterns/2-structured/source-code-inventory.md @@ -55,7 +55,7 @@ Can you get consistent answers within the Organization to questions like: Mockup dashboard | Mockup questionnaire :-------------------------:|:-------------------------: -![Mockup dashboard](../../assets/img/source-code-inventory-mockup-dashboard.PNG) | ![Mockup questionnaire](../../assets/img/source-code-inventory-mockup-questionnaire.PNG) +![Mockup dashboard](../../assets/img/source-code-inventory/source-code-inventory-mockup-dashboard.png) | ![Mockup questionnaire](../../assets/img/source-code-inventory/source-code-inventory-mockup-questionnaire.png) ### Define a Source Code Strategy Assessment Framework From f4e1fcea4456ae7decd06a6b9fe7e781529951c9 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sun, 13 Apr 2025 20:24:24 +0200 Subject: [PATCH 4/4] Use lower case spelling for 'organization' and 'legal entity' --- .../2-structured/source-code-inventory.md | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/patterns/2-structured/source-code-inventory.md b/patterns/2-structured/source-code-inventory.md index 723c6f2d3..5e4fcb94d 100644 --- a/patterns/2-structured/source-code-inventory.md +++ b/patterns/2-structured/source-code-inventory.md @@ -9,9 +9,9 @@ A unified source code inventory at organization-level addresses these issues, wh ## Problem -Given situations when InnerSource stakeholders do not value source code at the same level as other Organization's assets; when source code strategies are ad-hoc and different among legal entities with little consolidation at Organization-level; then it becomes harder both to select and support the right InnerSource project candidates as well as maximize business value of such a key asset. +Given situations when InnerSource stakeholders do not value source code at the same level as other organization's assets; when source code strategies are ad-hoc and different among legal entities with little consolidation at organization-level; then it becomes harder both to select and support the right InnerSource project candidates as well as maximize business value of such a key asset. -Can you get consistent answers within the Organization to questions like: +Can you get consistent answers within the organization to questions like: * How would you find all source code touched by anyone in your legal entity? * How would you find out who else can also access each of the above? @@ -21,10 +21,10 @@ Can you get consistent answers within the Organization to questions like: ## Context -* You work on Legal Entity within a complex Organization under continuous change (e.g. new acquisitions or changing business priorities). -* You cannot find all source code touched, shared and consumed within the Organization. +* You work on legal entity within a complex organization under continuous change (e.g. new acquisitions or changing business priorities). +* You cannot find all source code touched, shared and consumed within the organization. * You do not have a clear policy on default sharing level when creating a new project (e.g. Open Source, InnerSource or Closed Source). -* You cannot scan significant parts of the Organization's source code looking for duplication, similarity or code smells. +* You cannot scan significant parts of the organization's source code looking for duplication, similarity or code smells. * You do not know the existing ratios of Open Source, innerSource and Closed Source and their trend. * You cannot measure the diversity of contributions and resulting value for a given project. * You cannot identify and optimize tech stack diversity. @@ -32,14 +32,14 @@ Can you get consistent answers within the Organization to questions like: ## Forces -* Fragmentation of source code hosting systems in the Organization. -* Ad-hoc source code strategies scattered across the different Legal Entities in the Organization. +* Fragmentation of source code hosting systems in the organization. +* Ad-hoc source code strategies scattered across the different legal entities in the organization. * Continuously changing map of the relationships between: projects, repositories, products, tech stacks, domains, solutions, platforms, services, components, sub-systems, people, authors, teams, external repositories. -* Diverse software culture of teams across the Organization (e.g. more open to collaboration or more siloed). +* Diverse software culture of teams across the organization (e.g. more open to collaboration or more siloed). ## Solutions -### Set up an Organization-level source code inventory live dashboard +### Set up an organization-level source code inventory live dashboard * Combination of manual and automated input data sources to a single source of truth * API available to add new data sources and extend coverage of the source code repository @@ -59,7 +59,7 @@ Mockup dashboard | Mockup questionnaire ### Define a Source Code Strategy Assessment Framework -* Help to define a source code strategy including an explicit definition of policies at Organization and Legal Entity levels for: +* Help to define a source code strategy including an explicit definition of policies at organization and legal entity levels for: * Inventory * Sharing * Consumption @@ -69,25 +69,25 @@ Mockup dashboard | Mockup questionnaire ## Resulting Context -### For the Organization, Legal Entity and Project maintainers +### For the Organization, Legal Entity and Project Maintainers -* We have explicit policies at Organization and Legal Entity level on source code strategy (e.g. where to create new repository or how to select the right sharing level). -* We can find all source code touched, shared and consumed within the Organization or Legal Entity and take actions as needed. +* We have explicit policies at organization and legal entity level on source code strategy (e.g. where to create new repository or how to select the right sharing level). +* We can find all source code touched, shared and consumed within the organization or legal entity and take actions as needed. * We can measure the diversity of contributions and resulting business value for our project. * We can identify technical debt and determine the priorities for retirement (e.g. dead APIs/source). ### For InnerSource governance -* We can scan significant parts of our Organization's source code looking for opportunities of reuse, duplication, similarity or code smells. -* We know the ratios of Open Source, InnerSource and Closed Source within the Organization so we can steer as needed. +* We can scan significant parts of our organization's source code looking for opportunities of reuse, duplication, similarity or code smells. +* We know the ratios of Open Source, InnerSource and Closed Source within the organization so we can steer as needed. * We can identify and optimize tech stack diversity. -* We can create awareness and culture shift on certain Legal Entities as needed (e.g. ratio of Open Source and InnerSource below average). +* We can create awareness and culture shift on certain legal entities as needed (e.g. ratio of Open Source and InnerSource below average). ## Rationale -It creates a dynamic and extendable single source of truth for repositories to capture, visualize and act on source code repositories across the Organization. That helps to create awareness and focus efforts on the right direction. +It creates a dynamic and extendable single source of truth for repositories to capture, visualize and act on source code repositories across the organization. That helps to create awareness and focus efforts on the right direction. -The Source Code Strategy Assessment Framework helps teams to understand the value of intentional explicit policies on how to manage source code. It helps to create both continuous improvement cycles and references within the Organization of what others are doing. +The Source Code Strategy Assessment Framework helps teams to understand the value of intentional explicit policies on how to manage source code. It helps to create both continuous improvement cycles and references within the organization of what others are doing. ## Known Instances @@ -95,7 +95,7 @@ The Source Code Strategy Assessment Framework helps teams to understand the valu ## References -* Organization and Legal Entity terms as defined in the [InnerSource License Pattern - Glossary](../2-structured/innersource-license.md#glossary). +* "Organization" and "Legal Entity" terms as defined in the [InnerSource License Pattern - Glossary](../2-structured/innersource-license.md#glossary). * Explore using this pattern in combination with the [InnerSource Portal](../2-structured/innersource-portal.md) pattern. ## Status