Repository navigation
Add GitLab as Known Instance and draft Paired Onboarding Sprint pattern #926
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Merged
spier
merged 8 commits into
InnerSourceCommons:main
from
rrrutledge:add-gitlab-known-instance
Sep 4, 2026
Merged
Changes from 7 commits
Commits
Show all changes
8 commits
Select commit
Hold shift + click to select a range
1386d21
Add GitLab as Known Instance across two patterns
rrrutledge 4ae4a44
Draft new pattern: Paired Onboarding Sprint
rrrutledge b5355ae
Drop GitLab GDK from Internal Developer Platform Known Instances
rrrutledge 0adaa7a
List Paired Onboarding Sprint pattern in README
rrrutledge 514e185
Note GDK containerization as related context in Paired Onboarding Sprint
rrrutledge 63316d6
Skip O'Reilly webinar link in the PR link checker
rrrutledge ba11e28
Credit Raimund Hook as author of Paired Onboarding Sprint
rrrutledge 72cc69f
Apply Raimund Hook's review suggestions on Paired Onboarding Sprint
rrrutledge File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change | ||||
|---|---|---|---|---|---|---|
| @@ -0,0 +1,63 @@ | ||||||
| ## Title | ||||||
|
|
||||||
| Paired Onboarding Sprint | ||||||
|
|
||||||
| ## Patlet | ||||||
|
|
||||||
| Potential contributors who already depend on a shared project often stall before their first contribution - not for lack of ability, but because starting feels too costly to attempt alone. Pair a high-value potential contributor with a host-team engineer for a dedicated, bounded sprint to make their first real contribution together. | ||||||
|
|
||||||
| ## Problem | ||||||
|
|
||||||
| Potential contributors who already use a shared project are often the best future contributors, but self-service onboarding material alone rarely converts them. Common blockers aren't knowledge gaps a README can fix - they're activation-energy problems: not knowing where to start, not having time to learn an unfamiliar codebase alone, assuming their own team won't prioritize the work, or not wanting to take on open-ended maintenance. An interested, capable person can stay stuck at "aware and willing" indefinitely without ever attempting a first contribution. | ||||||
|
|
||||||
| ## Story | ||||||
|
|
||||||
| GitLab's DevRel Engineering team runs a program called Co-create. They identify a "high-value contributor" - someone already actively using GitLab's own tooling, with a clear ongoing need - and send one of their engineers to spend a dedicated week working alongside that person on a real feature. The engineer provides a clear guide through the codebase and the entire contribution process, not just pair-programming the code itself. By the end of the week the contributor has independent momentum: a real contribution in flight, a working understanding of how to contribute again unassisted, and in some cases the start of a path to mentoring other contributors themselves. | ||||||
|
Member
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more.
Suggested change
|
||||||
|
|
||||||
| ## Context | ||||||
|
|
||||||
| - A shared project already has self-service onboarding material (docs, good-first-issues, a portal) but conversion from "aware and interested" to "actually contributed" stays low. | ||||||
| - Some potential contributors are identifiable in advance as high-value - people already depending on or using the project - rather than random newcomers. | ||||||
| - The host team has enough capacity to dedicate one engineer's time for a bounded period. | ||||||
| - The barrier is activation energy and structural friction, not a lack of technical ability or interest. | ||||||
|
|
||||||
| ## Forces | ||||||
|
|
||||||
| **Host-team time cost vs. contributor lifetime value** - a dedicated engineer-week is a real cost, weighed against a contributor who may go on to contribute (and mentor others) indefinitely. | ||||||
|
|
||||||
| **Selecting who gets this treatment** - not every potential contributor can receive a dedicated sprint, so the host team must judge who is high-value enough to justify the investment. | ||||||
|
|
||||||
| **Risk of a one-off** - the contributor could complete the sprint but never contribute again without a clear handoff back to the project's normal self-service paths. | ||||||
|
|
||||||
| ## Solutions | ||||||
|
|
||||||
| Identify a specific, already-engaged potential contributor - not a cold newcomer - who has a clear need the project could meet. Assign one host-team engineer to work with them for a bounded period (GitLab uses one week) on a real feature or fix the contributor actually cares about. Provide a guide through the whole contribution workflow, not just the code: where things live, how review works, who to ask. At the end, make sure the contributor leaves with independent momentum - a merged or nearly-merged contribution, a working understanding of how to contribute again alone, and ideally an on-ramp toward mentoring future contributors themselves. | ||||||
|
|
||||||
| ## Resulting Context | ||||||
|
|
||||||
| The contributor is meaningfully more likely to keep contributing on their own, and the host team gains a return contributor without needing ongoing dedicated support. Some sprint participants go on to mentor other contributors, extending the pattern's value beyond the original pairing. This works best as a complement to self-service onboarding (see [InnerSource Portal](../2-structured/innersource-portal.md), [Standard Base Documentation](../2-structured/base-documentation.md)) rather than a replacement for it - the sprint is reserved for the highest-value candidates, not a scalable default path for every contributor. | ||||||
|
|
||||||
| ## Rationale | ||||||
|
|
||||||
| Self-service onboarding assumes the only barrier is information: if the docs are good enough, people will find their own way in. But for a contributor who is already interested and capable, the real barrier is often activation energy - the first contribution feels too costly to attempt alone, so it never gets attempted. A dedicated, bounded, human-guided sprint directly removes that activation-energy barrier for the contributors most worth the investment, converting passive users into active contributors and, sometimes, into future mentors themselves. | ||||||
|
|
||||||
| GitLab treats this as one piece of a broader respect for a contributor's time: alongside Co-create, they containerized their local development environment (the GitLab Development Kit), cutting setup from roughly two hours to under five minutes. The reasoning is the same either way - the less time a contributor spends fighting tools or navigating an unfamiliar codebase alone, the sooner they reach real contribution work, and the less likely they are to abandon the attempt. | ||||||
|
|
||||||
| ## Known Instances | ||||||
|
|
||||||
| * **GitLab** - GitLab's "Co-create" program identifies high-value potential contributors (people already using GitLab's own tooling) and sends an engineer to spend a dedicated week guiding them through their first real contribution, followed by support as they build independent momentum. See: [Break the contribution wall](https://www.youtube.com/watch?v=d3igPlTr4Ag) (InnerSource Commons, 2026, by Raimund Hook). | ||||||
|
spier marked this conversation as resolved.
Resolved
|
||||||
|
|
||||||
| ## Status | ||||||
|
|
||||||
| * Initial | ||||||
| * One known instance (GitLab) as of August 2026 - not yet validated across multiple organizations. | ||||||
|
|
||||||
| ## Authors | ||||||
|
|
||||||
| * Raimund Hook | ||||||
|
|
||||||
| ## Related Patterns | ||||||
|
|
||||||
| * [InnerSource Portal](../2-structured/innersource-portal.md) - self-service discovery this pattern complements rather than replaces. | ||||||
| * [Standard Base Documentation](../2-structured/base-documentation.md) - the self-service onboarding path most contributors should still use; this pattern is for the subset worth a dedicated sprint. | ||||||
| * [Trusted Committer](../2-structured/trusted-committer.md) - sprint participants who go on to mentor others are a natural path toward this role. | ||||||
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading. Please reload this page.