Skip to content

Commit 06ac78c

Browse files
feat: add initial draft of a new pattern 'walk the InnerSource talk'
This pattern has been collaboratively written by the team behind the social coding platform at Siemens, summarizing key lessons learned from implementing Open Source methodologies across diverse and globally distributed development teams. Co-authored-by: Florian Greinacher <florian@greinacher.de>
1 parent 99c3c83 commit 06ac78c

File tree

1 file changed

+152
-0
lines changed

1 file changed

+152
-0
lines changed
Lines changed: 152 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,152 @@
1+
## Title
2+
3+
Walk the InnerSource talk
4+
5+
## Patlet
6+
7+
Teams across the organization are encouraged to adopt InnerSource principles such as working openly, sharing code, and
8+
collaborating transparently. But, if the team behind the InnerSource initiative doesn’t follow these practices
9+
themselves, it undermines credibility and adoption. Therefore, this team should lead by example: documenting their
10+
decisions as code, working in the open, and treating their work as an InnerSource project to build trust and show others
11+
how it’s done.
12+
13+
## Problem
14+
15+
The team behind the InnerSource initiative promotes transparency, collaboration, and best practices across the
16+
organization. However, if the team itself does not adhere to these principles, others may perceive InnerSource as mere
17+
rhetoric rather than a transformative practice. Without leading by example, adoption and trust in InnerSource
18+
initiatives may suffer.
19+
20+
## Story (optional)
21+
22+
At Siemens, when the InnerSource journey began, many of the early contributors were deeply inspired by the Open Source
23+
culture, several were also active participants in community projects. For them, setting up an InnerSource platform
24+
wasn’t a stretch; it was a natural continuation of how they already worked: asynchronously across locations, sharing
25+
ideas through issues, and documenting decisions transparently.
26+
27+
This Open Source-inspired mindset gave the InnerSource platform a distinctly different character - transparent,
28+
collaborative, and developer-friendly - compared to the closed, proprietary environments many developers were used to.
29+
Unsurprisingly, it quickly attracted experts and engineers seeking more open, cross-team collaboration and meaningful
30+
technical exchange.
31+
32+
## Context
33+
34+
In many large organizations, IT services rely on what we might call a “TicketOps” model: users submit requests into a
35+
system, but the people and decisions behind the process remain invisible. This lack of transparency often breeds
36+
frustration and mistrust, making true collaboration across departments difficult.
37+
38+
In contrast, developer-centric initiatives like InnerSource thrive on openness and shared ownership. Instead of hiding
39+
behind tickets, teams work in open repositories, discuss decisions transparently, and empower others to contribute. This
40+
shift fosters trust, reduces the frustration of not knowing what happens behind the scenes, accelerates problem-solving,
41+
and turns support into collaboration.
42+
43+
## Forces
44+
45+
### What makes the problem difficult?
46+
47+
- In large, traditionally structured organizations, teams - especially platform, architecture, or governance groups -
48+
are often used to working behind closed doors. Decision-making happens in meetings, documentation is internal or
49+
scattered, and ownership is unclear. Shifting to transparent, open collaboration requires both cultural change and a
50+
reevaluation of existing workflows.
51+
- Working in the open can feel scary - when everything is public, people might hold back from contributing because they worry their work isn't perfect enough. This fear of not being "good enough" can stop many valuable ideas from being shared.
52+
- People in central roles may fear scrutiny, overload from unsolicited input, or loss of control. Additionally, moving
53+
towards open collaboration demands more discipline in documentation, async communication, and community management -
54+
skills not always prioritized in internal tooling teams.
55+
56+
### What are the trade-offs?
57+
58+
- **Transparency vs. Control**: Sharing decisions and code openly fosters trust, invites valuable feedback, and
59+
increases acceptance, especially when people feel included in the process. However, it also requires a mindset shift:
60+
embracing open discussion, being comfortable with disagreement, and being willing to justify decisions in public and
61+
potentially critical forums.
62+
63+
- **Speed vs. Quality**: working transparently can slow things down in the short term compared to quick, closed
64+
decision-making. However, this slower pace often leads to higher-quality outcomes: better-informed decisions, fewer
65+
misunderstandings, and solutions that are easier to maintain.
66+
67+
- **Effort vs. Reuse**: documenting decisions, maintaining contribution guidelines, and curating issues takes time. But
68+
this investment leads to higher reusability, easier onboarding, and better scaling of knowledge.
69+
70+
- **Risk vs. Trust**: opening up work may expose mistakes or half-finished ideas. But by showing authentic work in
71+
progress, teams build credibility and foster trust across organizational boundaries.
72+
73+
The solution - working in the open, documenting decisions transparently, and following InnerSource best practices
74+
internally - addresses these forces by modeling the desired behavior. It increases alignment with developer
75+
expectations, improves trust in the initiative, and helps shift the broader organizational culture over time.
76+
77+
## Solutions
78+
79+
✅ Verified Resolutions
80+
81+
These have been successfully applied in real-world InnerSource initiatives (including at Siemens) and are known to help
82+
solve the problem:
83+
84+
1. Use version-controlled repositories for all InnerSource-related assets (policies, guidelines, tooling code,
85+
documentation), accessible to all relevant developers.
86+
1. Make decisions in the open by using issue trackers and discussions rather than closed-door meetings or emails.
87+
1. Apply contribution workflows to internal platforms and tools exactly as recommended for InnerSource projects: open
88+
pull requests, reviews, contribution guidelines, etc.
89+
1. Document frequently asked questions (FAQs), design rationales, and change histories transparently, as part of the
90+
repositories.
91+
1. Encourage asynchronous collaboration, especially across locations and time zones, to foster inclusiveness and reduce
92+
dependency on synchronous coordination.
93+
1. Guide new contributors with patience and understanding, creating a welcoming environment where mistakes are seen as learning opportunities. Provide constructive feedback in a respectful and supportive manner, remembering that everyone was once a beginner.
94+
95+
💡 Possible Resolutions
96+
97+
These could be explored to address the problem further, depending on organizational context and maturity:
98+
99+
1. Create InnerSource “meta-projects” that transparently host governance decisions, tooling roadmaps, and shared
100+
architecture discussions - open to comment and contribution from the developer community.
101+
1. Embed technical community leads or advocates into platform/tooling teams to help translate feedback and improve
102+
transparency across organizational layers.
103+
1. Use lightweight tooling (e.g. chat bots, dashboards) to surface changes, decisions, and contributions happening
104+
within InnerSource-supporting teams, making their work more visible and discoverable.
105+
1. Promote a “working out loud” culture through internal blogs, changelogs, or recorded demos where teams share updates
106+
and learnings openly - even outside of the InnerSource platform.
107+
1. Set up health checks or self-assessments for InnerSource-supporting teams to reflect on how well they themselves are
108+
practicing the principles they advocate.
109+
110+
## Resulting Context
111+
112+
When the team behind the InnerSource initiative consistently applies the same principles they promote - working
113+
transparently, documenting decisions, and enabling contributions - credibility increases across the organization.
114+
Developers begin to see the InnerSource approach as authentic and achievable, not just aspirational.
115+
116+
This fosters greater trust, encourages broader adoption, and creates a feedback loop where teams start to mirror these
117+
practices in their own projects. The organization gradually shifts toward a more open, collaborative engineering
118+
culture.
119+
120+
However, this transparency can also surface new challenges, such as increased demand for contributions, the need for
121+
community moderation, or pressure on core maintainers. These may lead to follow-up patterns like "Growing a Trusted
122+
Committer Base" or "InnerSource Project Lifecycle Management" to ensure sustainability.
123+
124+
## Known Instances
125+
126+
- At Siemens, the experts behind the InnerSource initiative applied the same principles they advocated, developing key
127+
assets such as documentation portals and contribution tooling transparently in shared repositories. Discussions about
128+
governance, onboarding, and platform features were handled openly using issue trackers and pull requests. This visible
129+
commitment to openness not only boosted trust among developers but also encouraged other teams to adopt similar
130+
practices, accelerating InnerSource adoption organically across departments.
131+
132+
## Status (optional until merging)
133+
134+
> General pattern status is stored in GitHub's Label tagging - see any pull request. Note that this GitHub label tagging
135+
becomes less visible once the pattern is finalized and merged, so having some information in this field is helpful.
136+
You might store other related info here, such as review history: "Three of us reviewed this on 2/5/17 and it needs
137+
John's expertise before it can go further."
138+
139+
## Author(s)
140+
141+
- Florian Greinacher (Siemens AG)
142+
- Marion Deveaud (Siemens AG)
143+
- Nejc Habjan (Siemens AG)
144+
- Roger Meier (Siemens AG)
145+
146+
## Acknowledgments
147+
148+
- Antoine Auger (Siemens AG)
149+
- Diego Louzan
150+
- Ercan Uçan (Siemens AG)
151+
- Fabio Huser (Siemens AG)
152+
- Max Wittig (Siemens AG)

0 commit comments

Comments
 (0)