From f6eaaa58d05018d3f91c9288182c0ebe9a8b0609 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 15:58:17 +0100 Subject: [PATCH 01/11] First draft of the InnerSource Ambassador pattern --- patterns/1-initial/innersource-ambassador.md | 75 ++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 patterns/1-initial/innersource-ambassador.md diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md new file mode 100644 index 000000000..86ce8495f --- /dev/null +++ b/patterns/1-initial/innersource-ambassador.md @@ -0,0 +1,75 @@ +## Title + +InnerSource Ambassadors + +## Patlet + +To extend the reach and effectiveness of the InnerSource Program Office (ISPO), volunteer InnerSource Ambassadors act as the eyes, ears, and voice of the ISPO within their departments. They support InnerSource goals while maintaining their primary organizational roles. + +## Problem + +The ISPO cannot be everywhere at once within a large, decentralized organization. Without localized support, the ISPO struggles to understand the unique challenges and needs of different departments or regions and cannot effectively promote InnerSource practices across the organization. + +## Story (optional) + +In a multinational organization, the ISPO implemented InnerSource initiatives but noticed uneven adoption across departments. After appointing a local ambassador in one department, adoption rates improved as the ambassador tailored practices to the department's context and provided valuable feedback to the ISPO. + +## Context + +- The organization is large and has multiple independent departments. +- An ISPO has been established to drive InnerSource adoption. +- There is a need for consistent and tailored InnerSource implementation across diverse teams. +- Employees with a passion for collaboration and InnerSource principles are present within the organization. + +## Forces + +- **Geographical and organizational scale:** The ISPO cannot physically or logistically engage with every department. +- **Communication barriers:** Departments may have unique cultures and needs that are not immediately visible to the ISPO. +- **Workload balance:** Ambassadors must fulfill this role alongside their primary responsibilities. +- **Trust and credibility:** Ambassadors must be trusted by their teams and the ISPO. + +## Sketch (optional) + +*A diagram showing the ISPO at the center, with ambassadors positioned in various departments acting as bidirectional conduits of information and influence.* + +## Solutions + +- Identify and recruit volunteer ambassadors from across the organization who are enthusiastic about InnerSource. +- Train ambassadors on InnerSource principles, tools, and the goals of the ISPO. +- Establish clear expectations for ambassadors, including acting as a liaison, promoting InnerSource practices, and providing feedback to the ISPO. +- Create a support network among ambassadors to share best practices and foster a sense of community. +- Schedule regular check-ins between ambassadors and the ISPO to gather insights and provide guidance. + +## Resulting Context + +- Localized InnerSource support increases adoption and effectiveness. +- The ISPO gains valuable, real-time feedback on challenges, successes, and opportunities within different departments. +- Ambassadors become advocates for InnerSource, fostering a culture of collaboration. +- Workload balancing remains a challenge, but most ambassadors find the role rewarding and career-enhancing. + +## Rationale (optional) + +InnerSource Ambassadors leverage their existing knowledge of their departments and relationships within the organization to address challenges the ISPO cannot solve alone. This decentralization of responsibility enhances the ISPO's reach while maintaining centralized oversight. + +## Known Instances (optional) + +- A global financial services firm successfully used InnerSource Ambassadors to foster collaboration between its IT and business units. +- A technology company implemented this approach to overcome departmental silos during its InnerSource adoption. + +## Status (optional until merging) + +This pattern is in the **Draft** stage. Feedback is welcome, especially on ensuring ambassador workload balance and scaling the approach across very large organizations. + +## Author(s) (optional) + +- Sebastian Spier +- ChatGPT :) + +## Acknowledgments (optional) + + + +## Alias (optional) + +- Departmental InnerSource Representatives +- Local InnerSource Representatives \ No newline at end of file From a90c4283b5503c6a73abe0ce3bb2985f72d996f5 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 16:17:50 +0100 Subject: [PATCH 02/11] Replace the known instances that were made up by ChatGPT with a link to a post by SAP --- patterns/1-initial/innersource-ambassador.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 86ce8495f..310ec9379 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -14,7 +14,7 @@ The ISPO cannot be everywhere at once within a large, decentralized organization In a multinational organization, the ISPO implemented InnerSource initiatives but noticed uneven adoption across departments. After appointing a local ambassador in one department, adoption rates improved as the ambassador tailored practices to the department's context and provided valuable feedback to the ISPO. -## Context +## Context - The organization is large and has multiple independent departments. - An ISPO has been established to drive InnerSource adoption. @@ -51,10 +51,9 @@ In a multinational organization, the ISPO implemented InnerSource initiatives bu InnerSource Ambassadors leverage their existing knowledge of their departments and relationships within the organization to address challenges the ISPO cannot solve alone. This decentralization of responsibility enhances the ISPO's reach while maintaining centralized oversight. -## Known Instances (optional) +## Known Instances -- A global financial services firm successfully used InnerSource Ambassadors to foster collaboration between its IT and business units. -- A technology company implemented this approach to overcome departmental silos during its InnerSource adoption. +- *SAP* has a concept called [Open Source Champions](https://community.sap.com/t5/open-source-blogs/sap-open-source-champions/ba-p/13539587) that seems related ## Status (optional until merging) From 617f27bf171ce5e95086e1a13fe386c500b8ab9a Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 16:19:44 +0100 Subject: [PATCH 03/11] Apply automatic fixes --- patterns/1-initial/innersource-ambassador.md | 4 +--- 1 file changed, 1 insertion(+), 3 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 310ec9379..ad0f7103b 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -66,9 +66,7 @@ This pattern is in the **Draft** stage. Feedback is welcome, especially on ensur ## Acknowledgments (optional) - - ## Alias (optional) - Departmental InnerSource Representatives -- Local InnerSource Representatives \ No newline at end of file +- Local InnerSource Representatives From a4ea2630373c0c82a2bce80695dc9c5858a60643 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 19:07:47 +0100 Subject: [PATCH 04/11] Remove whitespace --- patterns/1-initial/innersource-ambassador.md | 76 ++++++++++---------- 1 file changed, 38 insertions(+), 38 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index ad0f7103b..54633de6d 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -1,72 +1,72 @@ -## Title +## Title -InnerSource Ambassadors +InnerSource Ambassadors -## Patlet +## Patlet -To extend the reach and effectiveness of the InnerSource Program Office (ISPO), volunteer InnerSource Ambassadors act as the eyes, ears, and voice of the ISPO within their departments. They support InnerSource goals while maintaining their primary organizational roles. +To extend the reach and effectiveness of the InnerSource Program Office (ISPO), volunteer InnerSource Ambassadors act as the eyes, ears, and voice of the ISPO within their departments. They support InnerSource goals while maintaining their primary organizational roles. -## Problem +## Problem -The ISPO cannot be everywhere at once within a large, decentralized organization. Without localized support, the ISPO struggles to understand the unique challenges and needs of different departments or regions and cannot effectively promote InnerSource practices across the organization. +The ISPO cannot be everywhere at once within a large, decentralized organization. Without localized support, the ISPO struggles to understand the unique challenges and needs of different departments or regions and cannot effectively promote InnerSource practices across the organization. -## Story (optional) +## Story (optional) -In a multinational organization, the ISPO implemented InnerSource initiatives but noticed uneven adoption across departments. After appointing a local ambassador in one department, adoption rates improved as the ambassador tailored practices to the department's context and provided valuable feedback to the ISPO. +In a multinational organization, the ISPO implemented InnerSource initiatives but noticed uneven adoption across departments. After appointing a local ambassador in one department, adoption rates improved as the ambassador tailored practices to the department's context and provided valuable feedback to the ISPO. ## Context -- The organization is large and has multiple independent departments. -- An ISPO has been established to drive InnerSource adoption. -- There is a need for consistent and tailored InnerSource implementation across diverse teams. -- Employees with a passion for collaboration and InnerSource principles are present within the organization. +- The organization is large and has multiple independent departments. +- An ISPO has been established to drive InnerSource adoption. +- There is a need for consistent and tailored InnerSource implementation across diverse teams. +- Employees with a passion for collaboration and InnerSource principles are present within the organization. -## Forces +## Forces -- **Geographical and organizational scale:** The ISPO cannot physically or logistically engage with every department. -- **Communication barriers:** Departments may have unique cultures and needs that are not immediately visible to the ISPO. -- **Workload balance:** Ambassadors must fulfill this role alongside their primary responsibilities. -- **Trust and credibility:** Ambassadors must be trusted by their teams and the ISPO. +- **Geographical and organizational scale:** The ISPO cannot physically or logistically engage with every department. +- **Communication barriers:** Departments may have unique cultures and needs that are not immediately visible to the ISPO. +- **Workload balance:** Ambassadors must fulfill this role alongside their primary responsibilities. +- **Trust and credibility:** Ambassadors must be trusted by their teams and the ISPO. -## Sketch (optional) +## Sketch (optional) -*A diagram showing the ISPO at the center, with ambassadors positioned in various departments acting as bidirectional conduits of information and influence.* +*A diagram showing the ISPO at the center, with ambassadors positioned in various departments acting as bidirectional conduits of information and influence.* -## Solutions +## Solutions -- Identify and recruit volunteer ambassadors from across the organization who are enthusiastic about InnerSource. -- Train ambassadors on InnerSource principles, tools, and the goals of the ISPO. -- Establish clear expectations for ambassadors, including acting as a liaison, promoting InnerSource practices, and providing feedback to the ISPO. -- Create a support network among ambassadors to share best practices and foster a sense of community. -- Schedule regular check-ins between ambassadors and the ISPO to gather insights and provide guidance. +- Identify and recruit volunteer ambassadors from across the organization who are enthusiastic about InnerSource. +- Train ambassadors on InnerSource principles, tools, and the goals of the ISPO. +- Establish clear expectations for ambassadors, including acting as a liaison, promoting InnerSource practices, and providing feedback to the ISPO. +- Create a support network among ambassadors to share best practices and foster a sense of community. +- Schedule regular check-ins between ambassadors and the ISPO to gather insights and provide guidance. -## Resulting Context +## Resulting Context -- Localized InnerSource support increases adoption and effectiveness. -- The ISPO gains valuable, real-time feedback on challenges, successes, and opportunities within different departments. -- Ambassadors become advocates for InnerSource, fostering a culture of collaboration. -- Workload balancing remains a challenge, but most ambassadors find the role rewarding and career-enhancing. +- Localized InnerSource support increases adoption and effectiveness. +- The ISPO gains valuable, real-time feedback on challenges, successes, and opportunities within different departments. +- Ambassadors become advocates for InnerSource, fostering a culture of collaboration. +- Workload balancing remains a challenge, but most ambassadors find the role rewarding and career-enhancing. -## Rationale (optional) +## Rationale (optional) -InnerSource Ambassadors leverage their existing knowledge of their departments and relationships within the organization to address challenges the ISPO cannot solve alone. This decentralization of responsibility enhances the ISPO's reach while maintaining centralized oversight. +InnerSource Ambassadors leverage their existing knowledge of their departments and relationships within the organization to address challenges the ISPO cannot solve alone. This decentralization of responsibility enhances the ISPO's reach while maintaining centralized oversight. ## Known Instances - *SAP* has a concept called [Open Source Champions](https://community.sap.com/t5/open-source-blogs/sap-open-source-champions/ba-p/13539587) that seems related -## Status (optional until merging) +## Status (optional until merging) -This pattern is in the **Draft** stage. Feedback is welcome, especially on ensuring ambassador workload balance and scaling the approach across very large organizations. +This pattern is in the **Draft** stage. Feedback is welcome, especially on ensuring ambassador workload balance and scaling the approach across very large organizations. -## Author(s) (optional) +## Author(s) (optional) - Sebastian Spier -- ChatGPT :) +- ChatGPT :) -## Acknowledgments (optional) +## Acknowledgments (optional) -## Alias (optional) +## Alias (optional) - Departmental InnerSource Representatives - Local InnerSource Representatives From ce85be35fe8fae23dceb6909d58d3f4d6f6b9680 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 19:12:55 +0100 Subject: [PATCH 05/11] Add aliases for the word 'ambassador' --- patterns/1-initial/innersource-ambassador.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 54633de6d..49a72fa12 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -68,5 +68,5 @@ This pattern is in the **Draft** stage. Feedback is welcome, especially on ensur ## Alias (optional) -- Departmental InnerSource Representatives -- Local InnerSource Representatives +- Departmental InnerSource Representatives/Champion/Ambassador +- Local InnerSource Representatives/Champion/Ambassador From 2dcfd71945243b8a8d73efeb1739d6cd70bf8904 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 19:13:30 +0100 Subject: [PATCH 06/11] Change status --- patterns/1-initial/innersource-ambassador.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 49a72fa12..567da261f 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -55,9 +55,9 @@ InnerSource Ambassadors leverage their existing knowledge of their departments a - *SAP* has a concept called [Open Source Champions](https://community.sap.com/t5/open-source-blogs/sap-open-source-champions/ba-p/13539587) that seems related -## Status (optional until merging) +## Status -This pattern is in the **Draft** stage. Feedback is welcome, especially on ensuring ambassador workload balance and scaling the approach across very large organizations. +- Initial ## Author(s) (optional) From 0b8a4ba7d7c7326f5b2337aff9618dc07e80669a Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 21 Dec 2024 19:14:09 +0100 Subject: [PATCH 07/11] Clean up titles --- patterns/1-initial/innersource-ambassador.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 567da261f..0d70e8525 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -10,7 +10,7 @@ To extend the reach and effectiveness of the InnerSource Program Office (ISPO), The ISPO cannot be everywhere at once within a large, decentralized organization. Without localized support, the ISPO struggles to understand the unique challenges and needs of different departments or regions and cannot effectively promote InnerSource practices across the organization. -## Story (optional) +## Story In a multinational organization, the ISPO implemented InnerSource initiatives but noticed uneven adoption across departments. After appointing a local ambassador in one department, adoption rates improved as the ambassador tailored practices to the department's context and provided valuable feedback to the ISPO. @@ -47,7 +47,7 @@ In a multinational organization, the ISPO implemented InnerSource initiatives bu - Ambassadors become advocates for InnerSource, fostering a culture of collaboration. - Workload balancing remains a challenge, but most ambassadors find the role rewarding and career-enhancing. -## Rationale (optional) +## Rationale InnerSource Ambassadors leverage their existing knowledge of their departments and relationships within the organization to address challenges the ISPO cannot solve alone. This decentralization of responsibility enhances the ISPO's reach while maintaining centralized oversight. @@ -59,7 +59,7 @@ InnerSource Ambassadors leverage their existing knowledge of their departments a - Initial -## Author(s) (optional) +## Authors - Sebastian Spier - ChatGPT :) From 3eb9c561425d450d2bab233a9f3924569afc9367 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Tue, 24 Dec 2024 10:21:30 +0100 Subject: [PATCH 08/11] Rewriting Patlet to focus on problem + solution --- patterns/1-initial/innersource-ambassador.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 0d70e8525..7934aeaf5 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -4,11 +4,12 @@ InnerSource Ambassadors ## Patlet -To extend the reach and effectiveness of the InnerSource Program Office (ISPO), volunteer InnerSource Ambassadors act as the eyes, ears, and voice of the ISPO within their departments. They support InnerSource goals while maintaining their primary organizational roles. +When driving InnerSource adoption through a large, decentralized organization it is hard to understand and address the local challenges that come up in different departments and regions. +Local volunteers, called InnerSource Ambassadors, provide localized support by promoting InnerSource principles and acting as a communication bridge between their teams and the ISPO. ## Problem -The ISPO cannot be everywhere at once within a large, decentralized organization. Without localized support, the ISPO struggles to understand the unique challenges and needs of different departments or regions and cannot effectively promote InnerSource practices across the organization. +The InnerSource Program Office (ISPO) cannot be everywhere at once within a large, decentralized organization. Without localized support, the ISPO struggles to understand the unique challenges and needs of different departments or regions and cannot effectively promote InnerSource practices across the organization. ## Story @@ -34,7 +35,7 @@ In a multinational organization, the ISPO implemented InnerSource initiatives bu ## Solutions -- Identify and recruit volunteer ambassadors from across the organization who are enthusiastic about InnerSource. +- Identify and recruit volunteer ambassadors from across the organization who are enthusiastic about InnerSource. They support InnerSource goals while maintaining their primary organizational roles. - Train ambassadors on InnerSource principles, tools, and the goals of the ISPO. - Establish clear expectations for ambassadors, including acting as a liaison, promoting InnerSource practices, and providing feedback to the ISPO. - Create a support network among ambassadors to share best practices and foster a sense of community. From c5884dc5eecbfb72f4309e90ea2a934bf58f4dba Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 4 Jan 2025 00:01:39 +0100 Subject: [PATCH 09/11] Cleanup Acknowledgements --- patterns/1-initial/innersource-ambassador.md | 8 +++++--- 1 file changed, 5 insertions(+), 3 deletions(-) diff --git a/patterns/1-initial/innersource-ambassador.md b/patterns/1-initial/innersource-ambassador.md index 7934aeaf5..f5cda7086 100644 --- a/patterns/1-initial/innersource-ambassador.md +++ b/patterns/1-initial/innersource-ambassador.md @@ -63,11 +63,13 @@ InnerSource Ambassadors leverage their existing knowledge of their departments a ## Authors - Sebastian Spier -- ChatGPT :) -## Acknowledgments (optional) +## Acknowledgments -## Alias (optional) +- [Russell R. Rutledge](https://github.com/rrrutledge) for sharing the idea and providing feedback +- [Guilherme Dellagustin](https://github.com/dellagustin-sap) for sharing a similar concept used for open source adoption + +## Alias - Departmental InnerSource Representatives/Champion/Ambassador - Local InnerSource Representatives/Champion/Ambassador From 47f2eb4dc6ac99e9ecf4dbc5cf71dec7bfeb0755 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 4 Jan 2025 00:06:38 +0100 Subject: [PATCH 10/11] Add new pattern to overview (README) --- README.md | 1 + 1 file changed, 1 insertion(+) diff --git a/README.md b/README.md index 6e1900727..281fee53e 100644 --- a/README.md +++ b/README.md @@ -87,6 +87,7 @@ Our mission * [Code of Conduct](/patterns/1-initial/code-of-conduct.md) - *Communications and interactions between collaborators are rude, not inclusive or offensive, harming and increasing the discussions without any value added. A Code of Conduct provides guidelines for establishing rules and expectations regarding behavior and interactions within the community to build stronger levels of collaboration.* * [Trusted Committer and Contributor Retrospectives](/patterns/1-initial/cross-team-retrospectives.md) - *A host team working with contributors outside of their own line of management constantly runs into misunderstandings. As a result collaboration becomes brittle and frustrating. Setting aside time for regular retrospectives for the InnerSource team consisting of trusted committers and contributors can help make communication smooth.* * [InnerSource Hackathon](/patterns/1-initial/innersource-hackathon.md) - *In a company, initially only InnerSource enthusiasts are interested and practicing InnerSource during the early stages of InnerSource adoption; not all engineering teams are willing or have enough time and resources to adopt InnerSource. In this scenario, it is good to provide a safe space to try and adopt InnerSource through an InnerSource Hackathon event within the company.* +* [InnerSource Ambassadors](/patterns/1-initial/innersource-hackathon.md) - *When driving InnerSource adoption through a large, decentralized organization it is hard to understand and address the local challenges that come up in different departments and regions. Local volunteers, called InnerSource Ambassadors, provide localized support by promoting InnerSource principles and acting as a communication bridge between their teams and the ISPO.*