Skip to content

Commit 3a35bc0

Browse files
committed
First draft of Contributor Journey Optimization pattern
1 parent 968c22e commit 3a35bc0

File tree

2 files changed

+82
-0
lines changed

2 files changed

+82
-0
lines changed
145 KB
Loading
Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,82 @@
1+
## Title
2+
3+
Contributor Journey Optimization
4+
5+
## Patlet
6+
7+
New contributors often struggle to progress smoothly through the various stages of engagement in an InnerSource project, leading to high drop-off rates and underutilized potential.
8+
By systematically evaluating and optimizing the Contributor Journey, projects can identify and remove friction points, enabling a more inclusive and efficient path to higher-value contributions.
9+
10+
## Problem
11+
12+
Many InnerSource projects fail to retain and grow their contributor base because potential contributors encounter barriers at different stages of engagement.
13+
These barriers may include lack of awareness, unclear onboarding processes, missing documentation, or inadequate mentorship.
14+
Without deliberate intervention, these challenges reduce the number of contributors reaching the trusted committer stage, limiting the project's sustainability and impact.
15+
16+
## Context
17+
18+
This pattern applies to InnerSource projects that:
19+
20+
- Seek to attract and grow an engaged community of contributors.
21+
- Experience a high drop-off rate of potential contributors at various stages.
22+
- Have contributors who struggle to transition from users to active participants.
23+
- Recognize that reducing friction in contributor onboarding and progression can lead to a healthier, more sustainable project.
24+
25+
## Forces
26+
27+
- **Awareness Barrier** – Many potential contributors are unaware of the project or do not understand how it aligns with their needs or interests.
28+
- **Onboarding Complexity** – The process of contributing is not well-documented or too complex, discouraging new contributors.
29+
- **Skill Gap** – Some contributors may lack the necessary technical or collaboration skills, requiring additional support.
30+
- **Lack of Mentorship** – Without guidance from experienced contributors, new contributors struggle to navigate the project and make meaningful contributions.
31+
- **Recognition and Retention** – Contributors may feel unrecognized or unsupported, leading them to disengage before reaching the trusted committer stage.
32+
33+
## Sketch (optional)
34+
35+
![](../../assets/img/contributor-journey-stages.jpg)
36+
37+
A visual representation of the Contributor Journey stages and common obstacles at each transition could be useful.
38+
39+
## Solution
40+
41+
1. **Map the Contributor Journey** – Identify key stages in the contributor journey: awareness, usage, non-code contributions, code contributions, and trusted committer status.
42+
2. **Identify Friction Points** – Conduct workshops or self-assessments to document impediments preventing contributors from progressing.
43+
3. **Prioritize and Address Issues** – Create a backlog of improvement tasks, prioritizing high-impact changes such as better documentation, streamlined onboarding, mentorship programs, or automated contribution workflows.
44+
4. **Implement and Iterate** – Apply solutions in an incremental fashion, continuously gathering feedback and refining the process.
45+
5. **Measure Success** – Track engagement metrics, contributor retention rates, and qualitative feedback to assess improvements and adjust strategies as needed.
46+
47+
## Resulting Context
48+
49+
After implementing this pattern, projects experience:
50+
51+
- Increased contributor engagement and retention.
52+
- A clearer, more inclusive onboarding process.
53+
- Faster transition from new contributor to active participant.
54+
- Higher rates of trusted committers, strengthening the project’s long-term sustainability.
55+
56+
## Rationale
57+
58+
By proactively identifying and addressing barriers at each stage of the Contributor Journey, projects can maximize both the value they gain from contributors and the value contributors gain from participation.
59+
An optimized journey fosters a thriving InnerSource community, leading to better collaboration and more sustainable projects.
60+
61+
## Known Instances
62+
63+
- Large software organizations with mature InnerSource programs have applied structured contributor journey workshops to boost engagement.
64+
- Open source communities often adopt similar strategies to improve contributor experience and retention.
65+
66+
## Status
67+
68+
- Initial
69+
70+
## Author(s)
71+
72+
- Guilherme Dellagustin
73+
- Sebastian Spier
74+
75+
## Acknowledgments
76+
77+
- TBD
78+
79+
## Alias
80+
81+
- Contributor Onboarding Optimization
82+
- Contributor Engagement Framework

0 commit comments

Comments
 (0)