Skip to content

Commit 30ffbc0

Browse files
committed
Adding pattern as outlined in gdoc. minor formatting fixes
1 parent c3cbef6 commit 30ffbc0

File tree

1 file changed

+58
-0
lines changed

1 file changed

+58
-0
lines changed
Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
## Title
2+
3+
Reluctance to accept contributions
4+
5+
## Problem
6+
7+
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.
8+
9+
## Context
10+
11+
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.
12+
13+
## Forces
14+
15+
* 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.
16+
* 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.
17+
* Contributors that are not part of the core team do not have the same knowledge as the core team has about the shared asset.
18+
* 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.
19+
* 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.
20+
21+
## Solution
22+
23+
Define a clear contribution process for potential contributors.
24+
25+
* Implement a “support warranty” of limited time duration (e.g. 30 days) during which the contributor fixes any issues that the core team finds.
26+
* Define clear contribution guidelines that define a set of expectations of contributions.
27+
* Define a contribution workflow that describes submission, review, and acceptance steps, and which specifies how contributions can be tested.
28+
* Provide training through tutorials, documentation, and one-on-one guidance.
29+
30+
## Resulting Context
31+
32+
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.
33+
34+
## See Also
35+
36+
Support Warranty, Negotiate Contributions, Architecture for Participation, Feature Advocate (Note: these patterns are currently under construction)
37+
38+
## Known Instances
39+
40+
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)
41+
42+
## Status
43+
44+
11 Oct 2016 - First draft
45+
13 Apr - Reviewed & Revised
46+
47+
## Author
48+
49+
Klaas-Jan Stol
50+
51+
## Acknowledgments
52+
53+
* Georg Grütter
54+
* Bob Hanmer
55+
* Udo Preiss
56+
* Padma Sudarsan
57+
* Tim Yao
58+
* Nick Yeates

0 commit comments

Comments
 (0)