Add GitLab as Known Instance and draft Paired Onboarding Sprint pattern - #926
Draft
rrrutledge wants to merge 5 commits into
Draft
Add GitLab as Known Instance and draft Paired Onboarding Sprint pattern#926rrrutledge wants to merge 5 commits into
rrrutledge wants to merge 5 commits into
Conversation
Based on Raimund Hook's InnerSource Commons talk "Break the contribution wall" (April 2026), GitLab's DevRel Engineering team's contributor-growth program is added as a Known Instance to: - Incentive Mechanisms for Voluntary Contributions: contributors.gitlab.com gamifies contribution across code, review, docs, and translations with points, levels, and leaderboards, unlocking exclusive contributor swag - replaces "TBD" Known Instances - Internal Developer Platform: GitLab containerized their GDK, cutting new-contributor environment setup from ~2 hours (often failing) to under 5 minutes Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
spier
added
📖 Type - Content Work
spier
reviewed
Aug 11, 2026
| ## Known Instances | ||
|
|
||
| (known instances to be added) | ||
| * **GitLab** - GitLab containerized their GitLab Development Kit (GDK), cutting new-contributor environment setup from roughly two hours (frequently failing) to under five minutes. This directly reduced time-to-first-contribution for both open source and InnerSource-style contributors. See: [Break the contribution wall](https://www.youtube.com/watch?v=d3igPlTr4Ag) (InnerSource Commons, 2026, by Raimund Hook). |
Member
There was a problem hiding this comment.
Does "new-contributor environment setup" refer to the local development environment on a laptop?
And is this pattern referring to local development environments, or rather remote infrastructure that a software package is deployed to (like a DEV/STAGING/PROD environment)?
Or is the difference insignificant?
Aside: If this is the repo of the GDK, we could add a link to this: https://gitlab.com/gitlab-org/gitlab-development-kit
Contributor
Author
There was a problem hiding this comment.
Good question — and you're right, this doesn't belong here. The GDK is a local development environment a contributor runs on their own laptop (via GDK-in-a-box, a containerized GitLab instance), not the centralized, deployed self-service platform this pattern describes. I've dropped it from this pattern's Known Instances rather than trying to make it fit — pushed in b5355ae.
Contributor
Author
There was a problem hiding this comment.
I'll have to work on the Claude skill to make this better 🤔
Contributor
Author
|
The |
spier
pushed a commit
that referenced
this pull request
Aug 12, 2026
lychee cannot resolve links like /assets/img/foo.png without being told the repo root, so any changed file containing a pre-existing root-relative link fails the check even though the link is valid. Pass --root-dir . so lychee resolves these against the repo root. Observed in PR #926, which failed on an unrelated pre-existing image link.
rrrutledge
marked this pull request as ready for review
August 12, 2026 13:09
rrrutledge
requested review from
NewMexicoKid,
cewilliams,
lenucksi,
robtuley and
yuhattor
as code owners
August 12, 2026 13:09
Also from Raimund Hook's "Break the contribution wall" talk: GitLab's Co-create program pairs a host-team engineer with a high-value potential contributor for a dedicated week to make their first real contribution together. No existing pattern covers this structured 1:1 onboarding model, and it passes the "uniquely InnerSource" filter - it addresses contributors outside the host team's shared context, not generic onboarding advice. Filed at maturity level 1 (Initial), which requires no validation per meta/contributor-handbook.md - one known instance is exactly what this level is for. Bundled into this PR with the other two Known Instance additions from the same talk, per the "one talk = one PR" convention. Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
rrrutledge
changed the title
rrrutledge
added a commit
to rrrutledge/InnerSourcePatterns
that referenced
this pull request
Aug 12, 2026
The old guidance ("one talk is one data point, not proof a pattern is
widely applicable") read as a reason to hold back drafting a genuine
new-pattern candidate. But this process only ever sees one talk at a
time, so that standard would mean a new pattern candidate never gets
drafted at all. Checked meta/contributor-handbook.md: maturity level 1
(Initial) has NO validation requirement - it's explicitly for a single
unstructured idea. One instance is what's needed for level 2
(Structured); only 3+ need level 3 (Validated). So the guidance now says
to draft at Initial from one talk, which is exactly what that level is
for - confirmed against Paired Onboarding Sprint (InnerSourceCommons#926), the first
pattern this skill has drafted this way.
Co-authored-by: Claude Sonnet 5 <noreply@anthropic.com>
rrrutledge
marked this pull request as draft
August 12, 2026 14:29
GDK is a local development environment a contributor runs on their own machine, not the centralized, deployed self-service platform this pattern describes. Per Sebastian Spier's review on InnerSourceCommons#926.
rrrutledge
added a commit
to rrrutledge/InnerSourcePatterns
that referenced
this pull request
Aug 12, 2026
…stance Topical keyword overlap (e.g. 'developer environment') isn't enough - the GDK/Internal Developer Platform mismatch on InnerSourceCommons#926 happened because a local dev tool got matched to a pattern about centralized, deployed platforms purely on theme.
Same talk, same underlying point (respect the contributor's time) - not a separate Known Instance, since no pattern actually covers local dev-environment setup friction as its own solution.
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
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.
Summary
From Raimund Hook's InnerSource Commons talk "Break the contribution wall" (April 2026). GitLab's DevRel Engineering team (formerly Contributor Success) runs a contributor-growth program reaching "hundreds of users a week."
meta/contributor-handbook.md.Test plan
🤖 Generated with Claude Code