You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
feat: add bullets from previous ISPO WG zoom summary
refactor: adjust patlet to 2 sentence problem solution
feat: add references to open source project guidance
refactor: adjust problem to be more specific
Copy file name to clipboardExpand all lines: patterns/1-initial/migrating-from-innersource-to-open-source.md
+33-16Lines changed: 33 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,11 +4,11 @@ Migrating from InnerSource to Open Source
4
4
5
5
## Patlet
6
6
7
-
When an InnerSource project succeeds internally and meets criteria for external release, establish a process that addresses legal, security, governance, and community readiness to transition the project to open source while maintaining its internal value.
7
+
When an InnerSource project succeeds internally and meets criteria for external release, organizations often lack a structured approach for the transition. Establish a process that addresses legal, security, governance, and community readiness to transition the project to open source while maintaining its internal value.
8
8
9
9
## Problem
10
10
11
-
Organizations with successful InnerSource projects may want to transition to open source but lack structured processes. Without proper planning, projects risk legal issues, security vulnerabilities, governance conflicts, and community challenges that could harm success and reputation.
11
+
Organizations with successful InnerSource projects may want to transition to open source but lack structured processes for this evolution. While InnerSource provides a foundation of collaborative development practices, internal governance, and community management skills, the transition to external open source introduces new challenges. Without proper planning, projects risk legal issues, security vulnerabilities, governance conflicts, and community challenges that could harm both the project's success and the organization's reputation in the broader open source ecosystem.
12
12
13
13
## Story
14
14
@@ -18,12 +18,12 @@ A tech company developed a popular internal tool using InnerSource, achieving st
18
18
19
19
This pattern applies when:
20
20
21
-
- An InnerSource project has achieved internal success and adoption.
22
-
- The organization has established InnerSource practices and governance.
23
-
- There is strategic value in releasing the project publicly.
21
+
- An InnerSource project has achieved internal success and adoption, demonstrating proven collaborative development practices.
22
+
- The organization has established InnerSource practices and governance, providing a foundation for external community management.
23
+
- There is strategic value in releasing the project publicly while maintaining its internal utility.
24
24
- Legal and compliance frameworks are in place for open source releases.
25
-
- The project team has experience with collaborative development practices.
26
-
- External market demand or strategic positioning justifies open sourcing.
25
+
- The project team has experience with InnerSource collaborative development practices and internal community management.
26
+
- External market demand or strategic positioning justifies open sourcing, leveraging the project's InnerSource success.
27
27
28
28
## Forces
29
29
@@ -41,12 +41,15 @@ This pattern applies when:
41
41
Establish a comprehensive migration process that includes:
42
42
43
43
1.**Pre-Migration Assessment**: Evaluate the project's readiness using established criteria, including adoption metrics, documentation quality, and community management capabilities
44
+
- Assess business value and strategic alignment for external release.
45
+
- Ensure InnerSource templates align with open source standards to reduce transition friction.
44
46
45
47
2.**Legal and Compliance Review**:
46
48
- Conduct a thorough code review to identify and remove proprietary information.
47
49
- Establish clear licensing terms and intellectual property ownership.
48
50
- Perform patent and copyright clearance.
49
51
- Create legal documentation for external contributors.
52
+
- Maintain contributor history and credits during the transition to avoid losing valuable contribution records.
50
53
51
54
3.**Security Hardening**:
52
55
- Remove internal credentials, API keys, and sensitive configuration.
@@ -58,7 +61,8 @@ Establish a comprehensive migration process that includes:
58
61
- Define decision-making processes that balance internal needs with community input to ensure effective outcomes.
59
62
- Establish maintainer roles and responsibilities.
60
63
- Create contribution guidelines and code of conduct.
61
-
- Design community management processes
64
+
- Design community management processes.
65
+
- Add contributor acknowledgment sections to READMEs to appropriately credit all contributors during the transition.
62
66
63
67
5.**Community Preparation**:
64
68
- Train maintainers on open source community management
@@ -83,24 +87,37 @@ Establish a comprehensive migration process that includes:
83
87
- Create escalation procedures for critical issues.
84
88
- Define success metrics and review cycles.
85
89
- Plan for long-term sustainability
90
+
- Implement systems to measure and demonstrate business value produced by open source developers.
91
+
- Identify and automate repetitive processes in project setup and maintenance.
86
92
87
93
## Resulting Context
88
94
89
95
After successful migration:
90
96
91
-
- The project gains external contributors and broader adoption.
92
-
- Internal teams develop open source community management skills.
93
-
- The organization builds a reputation within the open-source ecosystem.
97
+
- The project gains external contributors and broader adoption, building on its InnerSource foundation.
98
+
- Internal teams leverage their InnerSource community management experience to manage external contributors effectively.
99
+
- The organization builds a reputation within the opensource ecosystem, demonstrating a successful evolution from InnerSource to open source.
94
100
- Legal and compliance frameworks are established for future open source releases.
95
-
- The project may require ongoing resource allocation for community management.
96
-
- Internal development processes may need to adapt to the needs of the external community.
97
-
- New opportunities for collaboration and innovation emerge through external partnerships.
101
+
- The project may require ongoing resource allocation for community management, but it benefits from established InnerSource practices.
102
+
- Internal development processes adapt to external community needs while maintaining InnerSource principles.
103
+
- New opportunities for collaboration and innovation emerge through external partnerships, extending the collaborative culture developed through InnerSource.
104
+
- Open sourcing projects often leads to increased internal usage and adoption, contrary to initial expectations.
105
+
- Aligning InnerSource and open source templates reduces friction for future transitions.
98
106
99
107
## Rationale
100
108
101
-
Migrating from InnerSource to open source is a natural evolution for internal projects, but requires careful planning to avoid pitfalls. A structured approach addresses legal, security, and governance issues proactively. By building on InnerSource practices, organizations can leverage collaborative skillsand adapt to external community challenges.
109
+
Migrating from InnerSource to open source is a natural evolution for successful internal projects, but requires careful planning to avoid pitfalls. A structured approach addresses legal, security, and governance issues proactively. By building on established InnerSource practices, organizations can leverage their collaborative development skills, community management experience, and internal governance structures to adapt to external community challenges.
102
110
103
-
This migration strikes a balance between organizational needs and open-source community expectations, resulting in sustainable projects that benefit both. The gradual approach enables learning and adaptation while minimizing risks to the project and the organization.
111
+
This migration leverages the foundation of InnerSource success—proven collaboration patterns, established contribution workflows, and internal community management—to create sustainable open source projects. The gradual approach enables organizations to apply their InnerSource learnings while minimizing risks to both the project and the organization's reputation in the broader open source ecosystem.
112
+
113
+
## References
114
+
115
+
-[Open Source Guide: How to Contribute to Open Source](https://opensource.guide/how-to-contribute/)
116
+
-[Mozilla's Open Source Guidelines](https://www.mozilla.org/en-US/about/policy/lean-data/build-security/)
117
+
-[Google's Open Source Documentation](https://opensource.google/docs/)
118
+
-[The Open Source Way](https://www.theopensourceway.org/)
119
+
-[GitHub's Open Source Guide](https://github.com/github/opensource.guide)
120
+
-[Apache Software Foundation: How to Open Source](https://www.apache.org/dev/apply-license.html)
0 commit comments