From 30ffbc0b6fd7b5ab7ee22a92d9f9df63d0d437e2 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 15 Aug 2020 19:07:27 +0200 Subject: [PATCH 1/4] Adding pattern as outlined in gdoc. minor formatting fixes --- .../reluctance-to-accept-contributions.md | 58 +++++++++++++++++++ 1 file changed, 58 insertions(+) create mode 100644 patterns/1-initial/reluctance-to-accept-contributions.md diff --git a/patterns/1-initial/reluctance-to-accept-contributions.md b/patterns/1-initial/reluctance-to-accept-contributions.md new file mode 100644 index 000000000..3ae5bacf6 --- /dev/null +++ b/patterns/1-initial/reluctance-to-accept-contributions.md @@ -0,0 +1,58 @@ +## Title + +Reluctance to accept contributions + +## Problem + +The core team that owns a shared asset is reluctant to adopt contributions of contributing business divisions, because this implies adoption of the maintenance responsibility for the contributed software as well, a burden the core team does not want to adopt. + +## Context + +An organizational unit (e.g. a business division or development team) is using an inner source product (a ‘shared asset’), and finds it is missing a certain feature that they need and would like to integrate into the shared asset. The core team that owns the shared asset is responsible for its design and maintenance. The potentially contributing organizational unit has no champion on the core team. + +## Forces + +* The core team is responsible for maintenance, and therefore accepting contributions implies accepting the maintenance burden of new contributions. The core team is reluctant to take on this burden. +* The unit that uses the asset requires the feature to be implemented for their product, but it is not clear where or how the feature “fits”--and thus they have difficulty implementing it because they lack knowledge of the shared asset. +* Contributors that are not part of the core team do not have the same knowledge as the core team has about the shared asset. +* The core team is offered a contribution that doesn’t fit with their vision of the shared asset--the contributor doesn’t understand all the intricacies that the core team needs to consider. +* Contributions are not suitable for the core team to handle, either because of quality problems (e.g. lack of architectural compliance) or that the contribution is too large--the contributor isn’t aware of how to contribute. + +## Solution + +Define a clear contribution process for potential contributors. + +* Implement a “support warranty” of limited time duration (e.g. 30 days) during which the contributor fixes any issues that the core team finds. +* Define clear contribution guidelines that define a set of expectations of contributions. +* Define a contribution workflow that describes submission, review, and acceptance steps, and which specifies how contributions can be tested. +* Provide training through tutorials, documentation, and one-on-one guidance. + +## Resulting Context + +Potential contributors have clear guidance available and process to follow so they know what to consider when preparing contributions. The core team is better able to handle incoming contributions. + +## See Also + +Support Warranty, Negotiate Contributions, Architecture for Participation, Feature Advocate (Note: these patterns are currently under construction) + +## Known Instances + +Philips Healthcare, “Feature Advocate” described in: VK Gurbani et al. (2010) Managing a corporate open source software asset, Communications of the ACM vol. 53(2) + +## Status + +11 Oct 2016 - First draft +13 Apr - Reviewed & Revised + +## Author + +Klaas-Jan Stol + +## Acknowledgments + +* Georg Grütter +* Bob Hanmer +* Udo Preiss +* Padma Sudarsan +* Tim Yao +* Nick Yeates From 0e49c3cef18e26b286c308646e97543d175569cd Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 15 Aug 2020 19:08:20 +0200 Subject: [PATCH 2/4] fixes InnerSource spelling --- patterns/1-initial/reluctance-to-accept-contributions.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/patterns/1-initial/reluctance-to-accept-contributions.md b/patterns/1-initial/reluctance-to-accept-contributions.md index 3ae5bacf6..3ac7c4ad2 100644 --- a/patterns/1-initial/reluctance-to-accept-contributions.md +++ b/patterns/1-initial/reluctance-to-accept-contributions.md @@ -8,7 +8,7 @@ The core team that owns a shared asset is reluctant to adopt contributions of co ## Context -An organizational unit (e.g. a business division or development team) is using an inner source product (a ‘shared asset’), and finds it is missing a certain feature that they need and would like to integrate into the shared asset. The core team that owns the shared asset is responsible for its design and maintenance. The potentially contributing organizational unit has no champion on the core team. +An organizational unit (e.g. a business division or development team) is using an InnerSource product (a ‘shared asset’), and finds it is missing a certain feature that they need and would like to integrate into the shared asset. The core team that owns the shared asset is responsible for its design and maintenance. The potentially contributing organizational unit has no champion on the core team. ## Forces From 8e5b9c13184cf84e23316f66ed09bd7cb2008917 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 15 Aug 2020 19:23:35 +0200 Subject: [PATCH 3/4] Adding missing template elements. Also linking from README to .md file, rather than to the gdoc. --- README.md | 2 +- .../reluctance-to-accept-contributions.md | 14 ++++++++++++-- 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 3904772fb..6e6025f5a 100644 --- a/README.md +++ b/README.md @@ -48,7 +48,7 @@ possible to either deploy the same service in independent environments with sepa * [Assisted Compliance](https://github.com/InnerSourceCommons/InnerSourcePatterns/pull/74) - *Helping repo owners be compliant by writing their CONTRIBUTING.md for them as a pull request.* * [Cross-Team Project Valuation](patterns/2-structured/crossteam-project-valuation.md) - *It's hard to sell the value of cross-team, inner sourced 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.* -* [Reluctance to Receive Contributions](https://docs.google.com/document/d/13QDN-BpE_BixRFVGjao32n4Ctim0ROXAHbBWMBOijb4/edit) - *Core owner of shared asset is reluctant to take contributions due to the required maintenance that comes with them.* +* [Reluctance to Receive Contributions](patterns/1-initial/reluctance-to-accept-contributions.md) - *Core owner of shared asset is reluctant to take contributions due to the required maintenance that comes with them.* * [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.* * [Overcome Acquisition Based Silos - Developers](patterns/2-structured/overcome-acquisition-based-silos-developer.md) * [Overcome Acquisition Based Silos - Managers](patterns/2-structured/overcome-acquisition-based-silos-manager.md) diff --git a/patterns/1-initial/reluctance-to-accept-contributions.md b/patterns/1-initial/reluctance-to-accept-contributions.md index 3ac7c4ad2..e6cc5d566 100644 --- a/patterns/1-initial/reluctance-to-accept-contributions.md +++ b/patterns/1-initial/reluctance-to-accept-contributions.md @@ -2,13 +2,17 @@ Reluctance to accept contributions +## Patlet + +TBD + ## Problem The core team that owns a shared asset is reluctant to adopt contributions of contributing business divisions, because this implies adoption of the maintenance responsibility for the contributed software as well, a burden the core team does not want to adopt. ## Context -An organizational unit (e.g. a business division or development team) is using an InnerSource product (a ‘shared asset’), and finds it is missing a certain feature that they need and would like to integrate into the shared asset. The core team that owns the shared asset is responsible for its design and maintenance. The potentially contributing organizational unit has no champion on the core team. +An organizational unit (e.g. a business division or development team) is using an InnerSource product (a ‘shared asset’), and finds it is missing a certain feature that they need and would like to integrate into the shared asset. The core team that owns the shared asset is responsible for its design and maintenance. The potentially contributing organizational unit has no champion on the core team. ## Forces @@ -18,7 +22,7 @@ An organizational unit (e.g. a business division or development team) is using a * The core team is offered a contribution that doesn’t fit with their vision of the shared asset--the contributor doesn’t understand all the intricacies that the core team needs to consider. * Contributions are not suitable for the core team to handle, either because of quality problems (e.g. lack of architectural compliance) or that the contribution is too large--the contributor isn’t aware of how to contribute. -## Solution +## Solutions Define a clear contribution process for potential contributors. @@ -56,3 +60,9 @@ Klaas-Jan Stol * Padma Sudarsan * Tim Yao * Nick Yeates + +## References + +Pattern was first created in the gDoc: [Reluctance to Receive Contributions](https://docs.google.com/document/d/13QDN-BpE_BixRFVGjao32n4Ctim0ROXAHbBWMBOijb4/edit) + +(this section can be deleted once the conversion from gDoc to markdown is complete) From fe4ef83f8909fa2c1bffec3de57a317e382be415 Mon Sep 17 00:00:00 2001 From: Sebastian Spier Date: Sat, 26 Sep 2020 18:36:13 +0200 Subject: [PATCH 4/4] add link to known pattern. provide context for 3 patterns not known. change order of sections. --- .../reluctance-to-accept-contributions.md | 14 ++++++++++---- 1 file changed, 10 insertions(+), 4 deletions(-) diff --git a/patterns/1-initial/reluctance-to-accept-contributions.md b/patterns/1-initial/reluctance-to-accept-contributions.md index e6cc5d566..425aaf06b 100644 --- a/patterns/1-initial/reluctance-to-accept-contributions.md +++ b/patterns/1-initial/reluctance-to-accept-contributions.md @@ -35,14 +35,20 @@ Define a clear contribution process for potential contributors. Potential contributors have clear guidance available and process to follow so they know what to consider when preparing contributions. The core team is better able to handle incoming contributions. -## See Also - -Support Warranty, Negotiate Contributions, Architecture for Participation, Feature Advocate (Note: these patterns are currently under construction) - ## Known Instances Philips Healthcare, “Feature Advocate” described in: VK Gurbani et al. (2010) Managing a corporate open source software asset, Communications of the ACM vol. 53(2) +## See Also + +* Support Warranty - most likely [30 Day Warranty](../2-structured/30-day-warranty.md) +* Negotiate Contributions (unknown pattern) +* Architecture for Participation (unknown pattern) +* Feature Advocate (unknown pattern) + +*Note:* +The last 3 patterns above were mentioned to be "under construction" at the time where this pattern was written. Right now we don't know where these patterns are. + ## Status 11 Oct 2016 - First draft