Scaling Internal Collaboration with Open Source Operating Models #InnerSourceSummit2025 ๐Ÿ”— **Source:** [Scaling Internal Collaboration with Open Source Operating Models #InnerSourceSummit2025](https://www.youtube.com/watch?v=ggF3fIT5lh8) > [!note]+ Document Notes > tags: [innersource, collaboration, developer-experience] > author: InnerSource Summit > source: YouTube > reference: https://www.youtube.com/watch?v=ggF3fIT5lh8 > date created: 2025-01-12 19:30 > > # ๐Ÿท๏ธ Title: Scaling Internal Collaboration with Open Source Operating Models > <!-- deep-read:sections start --> ## ๐Ÿงฐ Action Inbox - [H1] Audit current projects for clear maintainer documentation โ€” eliminate ownership ambiguity #governance - [H2] Establish review timeline SLAs and communicate expectations โ€” reduce PR frustration #process - [H3] Implement project discovery system to prevent duplicated work โ€” increase reuse metrics #visibility ## ๐Ÿงญ Table of Contents - [๐Ÿ“ Summary](#-summary) - [๐Ÿ“– Main Content](#-main-content) - [๐Ÿ—’๏ธ Notes](#๏ธ-notes) - [๐Ÿ“š References](#-references) - [๐Ÿ—ฃ๏ธ Paraphrase](#๏ธ-paraphrase) - [๐Ÿ“ฐ Newsletter](#-newsletter) - [โœ… Action Items](#-action-items) - [๐Ÿงช Hypotheses](#-hypotheses) - [๐Ÿ“Š Methodology](#-methodology) - [โ“ Questions](#-questions) - [๐Ÿ”ฎ Future Research](#-future-research) - [๐Ÿ’ก Implications](#-implications) - [๐Ÿง  Learning Styles Assessment](#-learning-styles-assessment) - [๐Ÿ“Š Accessibility Assessment](#-accessibility-assessment) - [๐ŸŒ DEIB Assessment](#-deib-assessment) - [โœ… Logical Validity](#-logical-validity) - [๐Ÿ›ก๏ธ DARVO Analysis](#-darvo-analysis) - [๐ŸŽฏ Conclusion](#-conclusion) ### ๐Ÿ”— References - [InnerSource Commons](https://innersourcecommons.org/) - [Open Source Program Office](https://todogroup.org/) ## ๐Ÿ“ Summary - **What happened**: Developer advocate presents framework for scaling internal collaboration using open source operating models at InnerSource Summit Berlin - **Why it matters**: Organizations face duplicated work, unclear ownership, slow reviews, and limited visibility across teams - **Key stakeholders**: Engineering teams, solution engineers, OSPOs, and technical leadership - **Risks and tradeoffs**: Requires organizational commitment to process change and cultural shift from isolated to collaborative work - **Bottom line**: Apply proven open source practices internally through structured contribution paths, governance, and organization-wide principles ## ๐Ÿ“– Main Content The presentation addresses common collaboration challenges in software development that plague both internal teams and open source projects: unclear ownership, slow review cycles, duplicated work, and limited project visibility. The speaker uses examples from their payment company experience, noting how solution engineers across 27 global offices often build identical integration examples independently. **Core Framework Components:** 1. **Contribution Path Design**: Clear guidelines, heavy documentation, automation, and continuous improvement 2. **Governance Structure**: Clear maintainers, sustainability planning, decision records, and review timelines 3. **Scaling Principles**: Compliance (consistent structure), collaboration (discovery before building), and communication (transparent change management) The maturity model progresses from isolated work through emerging awareness, structured adoption, to full cultural transformation where collaboration becomes default behavior. **Measurement Strategy**: Track onboarding time, review turnaround, cross-team contributions, and reuse rates to demonstrate impact and secure leadership buy-in. ## ๐Ÿ—’๏ธ Notes #### โฑ๏ธ [00:00](https://youtu.be/ggF3fIT5lh8?t=0) โ€” [H1] Introduction and speaker background - Key idea: Developer advocate at payment company with OSPO experience and community organizing background - Evidence: "Seven years in software development, open source advocate, past community organizer" #### โฑ๏ธ [02:15](https://youtu.be/ggF3fIT5lh8?t=135) โ€” [H2] Solution engineer duplication problem - Key idea: Global teams unknowingly build identical integration examples for similar customer use cases - Evidence: "At Adyen we have about 27 offices globally, probably amounts to several duplicated projects in laptops of solution engineers" #### โฑ๏ธ [03:45](https://youtu.be/ggF3fIT5lh8?t=225) โ€” [H2] Internal service integration frustrations - Key idea: Engineers struggle with undocumented internal services and unclear ownership - Evidence: "Find it very hard to know who owns the service, no documentation on how to integrate with LDAP APIs" #### โฑ๏ธ [05:30](https://youtu.be/ggF3fIT5lh8?t=330) โ€” [H1] Four common collaboration challenges - Key idea: Unclear ownership, slow reviews, duplicated work, and limited visibility plague internal development - Evidence: "Seven days before PR gets merged, can be so frustrating for engineers" #### โฑ๏ธ [07:15](https://youtu.be/ggF3fIT5lh8?t=435) โ€” [H2] Unstructured inner source still creates problems - Key idea: Simply making repositories internally visible doesn't solve collaboration issues without organization - Evidence: "Fragmented efforts, teams still build in silos, projects built in silos even if collaborating" #### โฑ๏ธ [08:45](https://youtu.be/ggF3fIT5lh8?t=525) โ€” [H1] Open source communities already solved these problems - Key idea: Standard open source practices provide proven models for internal collaboration - Evidence: "Open source community has solved this problem a while back, very standard community" #### โฑ๏ธ [10:00](https://youtu.be/ggF3fIT5lh8?t=600) โ€” [H1] Designing predictable contribution paths - Key idea: Clear guidelines, documentation, automation, and continuous improvement enable smooth contributions - Evidence: "Good policies look like they don't exist because everyone already understands them" #### โฑ๏ธ [12:30](https://youtu.be/ggF3fIT5lh8?t=750) โ€” [H2] Documentation requirements for every project - Key idea: Every internal project needs comprehensive documentation beyond basic README files - Evidence: "Several markdown files explaining architecture, contribution process, security structure implementation" #### โฑ๏ธ [13:45](https://youtu.be/ggF3fIT5lh8?t=825) โ€” [H2] Automation over manual processes - Key idea: Automate code quality, security checks, and compliance rather than manual reviews - Evidence: "Shouldn't have scenario where somebody physically checks code compliance, should be automated process" #### โฑ๏ธ [15:15](https://youtu.be/ggF3fIT5lh8?t=915) โ€” [H1] Governance through clear maintainers - Key idea: Document ownership clearly and plan for maintainer succession to prevent abandoned projects - Evidence: "Project should not die when owners leave, always someone else to reach out to" #### โฑ๏ธ [16:30](https://youtu.be/ggF3fIT5lh8?t=990) โ€” [H2] Decision records and review timelines - Key idea: Document all architectural decisions and set clear expectations for review cycles - Evidence: "From experience reviewing projects, you should tell users how long they wait before PR merged" #### โฑ๏ธ [18:00](https://youtu.be/ggF3fIT5lh8?t=1080) โ€” [H1] Three scaling principles from OSPO - Key idea: Compliance, collaboration, and communication enable organization-wide adoption - Evidence: "Make collaboration a principle so team members look at other projects before reinventing wheel" #### โฑ๏ธ [20:00](https://youtu.be/ggF3fIT5lh8?t=1200) โ€” [H2] Inner source maturity levels - Key idea: Organizations progress from isolated work through emerging adoption to cultural transformation - Evidence: "Goal should be getting from wherever you are to inner source culture where collaboration becomes default" #### โฑ๏ธ [21:30](https://youtu.be/ggF3fIT5lh8?t=1290) โ€” [H1] Measuring developer experience impact - Key idea: Track onboarding time, review turnaround, cross-team contributions, and reuse rates - Evidence: "How long does it take developer to pick up API and integrate? Measure before and after" #### โฑ๏ธ [23:00](https://youtu.be/ggF3fIT5lh8?t=1380) โ€” [H1] Key takeaways and starting point - Key idea: Design predictable paths, build lightweight governance, apply shared principles, and measure impact - Evidence: "Start from where you are and have vision to be inner source driven culture" ## ๐Ÿ“š References - [InnerSource Commons](https://innersourcecommons.org/) - [TODO Group OSPO Guide](https://todogroup.org/) - [Backstage Software Catalog](https://backstage.io/) ## ๐Ÿ—ฃ๏ธ Paraphrase - Organizations waste resources when teams unknowingly duplicate work across regions and departments due to poor project visibility and discovery mechanisms - Internal development suffers from the same collaboration problems as poorly managed open source projects: unclear ownership, slow feedback cycles, and fragmented efforts - Applying proven open source governance models internallyโ€”clear contribution paths, documented ownership, automated processesโ€”transforms isolated work into collaborative culture ## ๐Ÿ“ฐ Newsletter **Transform Internal Collaboration with Open Source Practices** Tired of teams building the same solutions in isolation? A compelling presentation from InnerSource Summit Berlin shows how to scale collaboration using proven open source operating models. The key insight: internal development faces identical challenges to poorly managed open source projectsโ€”unclear ownership, slow reviews, duplicated work, and limited visibility. The solution isn't just making repositories internally visible, but applying structured open source practices. **Three-Part Framework:** - **Contribution Paths**: Clear guidelines, comprehensive documentation, automated checks - **Governance**: Documented maintainers, decision records, review timelines - **Scaling Principles**: Organization-wide compliance, collaboration-first culture, transparent communication Track success through onboarding time, review turnaround, cross-team contributions, and reuse rates to demonstrate impact to leadership. Ready to move from building in silos to collaborative culture? Start where you are and apply these time-tested open source practices internally. Resources: [InnerSource Commons](https://innersourcecommons.org/), [OSPO Guide](https://todogroup.org/), [Backstage](https://backstage.io/) ## โœ… Action Items #### DevRel - Developer experience: Audit internal project documentation gaps, create contribution path templates - Education: Design workshops on inner source best practices, establish office hours for collaboration questions - Developer marketing: Create case studies showcasing successful cross-team collaborations and reuse metrics - Community management: Set up internal forums for project discovery, moderate cross-team collaboration discussions #### OSPO - Policy & Governance: Develop internal project compliance standards, create maintainer succession templates - Software Inventory: Implement project discovery platform, track cross-team dependencies and reuse rates - Developer Support: Provide inner source tooling training, create automated compliance checking tools - Strategic Alignment: Establish KPIs for collaboration culture, measure onboarding time and review turnaround improvements #### Community - Maintainers: Create ownership documentation standards, establish review timeline SLAs and succession planning - Contributors: Design onboarding paths for cross-team contributions, implement first-issue programs for internal projects - Ecosystem: Build project discovery mechanisms, coordinate cross-team integration standards #### WordPress - Core: Apply inner source principles to core contribution workflows, improve maintainer succession planning - Documentation: Audit DevHub and HelpHub for ownership clarity, establish review timeline expectations - Community: Create inner source best practices guides for meetup organizers and WordCamp contributors - Meta: Implement project discovery features on .org infrastructure, track cross-team collaboration metrics #### The WPCC - Programs: Design inner source fellowship programs, provide microgrants for cross-organization collaboration tools - Projects: Run governance clinics teaching inner source principles, fund documentation sprints for internal projects #### FAIR - Technical independence: Ensure inner source practices don't create vendor lock-in, maintain metadata portability - Governance artifacts: Create inner source policy templates, establish operator agreements for shared internal infrastructure ## ๐Ÿงช Hypotheses - Teams with clear maintainer documentation and review timelines will show measurably faster onboarding times compared to projects with unclear ownership - Organizations implementing automated compliance checking will see increased cross-team contribution rates within six months - Project discovery platforms will reduce duplicated work by 40% when combined with collaboration-first cultural principles - Inner source maturity progression correlates with improved developer satisfaction scores and reduced time-to-market metrics ### ๐Ÿ“Š Methodology - Study design: Compare onboarding times, review turnaround, and cross-team contributions before/after inner source implementation across multiple organizations - Data sources: Git analytics, developer surveys, project metadata, and collaboration platform metrics - Experiments: A/B test different governance models and measure impact on reuse rates and developer experience ### โ“ Questions - How do we balance governance overhead with development velocity in fast-moving organizations? - What specific automation tools most effectively reduce manual review burden while maintaining code quality? - How can organizations measure and incentivize cultural transformation toward collaboration-first mindsets? ### ๐Ÿ”ฎ Future Research - Long-term impact studies on inner source adoption across different organizational sizes and cultures - Integration patterns between inner source practices and existing DevOps toolchains and CI/CD pipelines - Cross-industry comparison of inner source maturity models and their effectiveness in different business contexts ### ๐Ÿ’ก Implications - **Practice**: Teams need structured approaches to transition from ad-hoc sharing to systematic inner source practices - **Policy**: Organizations require governance frameworks that enable rather than restrict internal collaboration - **Education**: Developer education must include collaboration skills and open source practices, not just technical implementation - **Funding**: Budget allocation should account for tooling, process development, and cultural change management in inner source initiatives ### ๐Ÿง  Learning Styles Assessment Reading level estimate: Flesch-Kincaid Grade Level 12 #### ๐Ÿ‘€ Visual learners - Present: Maturity level diagram, organizational structure examples - Improve: Process flow diagrams, before/after collaboration visualizations, governance structure charts #### ๐Ÿ”Š Aural learners - Present: Conference presentation format with clear verbal explanations - Improve: Audio summary of key frameworks, podcast-style discussion of implementation challenges #### ๐Ÿ—ฃ๏ธ Verbal learners - Present: Clear definitions of inner source terms, analogies to open source practices - Improve: Storytelling around transformation examples, comparison frameworks between traditional and inner source approaches #### ๐Ÿงฉ Kinesthetic learners - Present: Step-by-step implementation guidance, actionable takeaways - Improve: Hands-on workshops for governance setup, interactive maturity assessment tools, practical templates #### ๐Ÿง  Logical learners - Present: Structured three-part framework, clear progression through maturity levels - Improve: Decision trees for governance choices, metrics dashboards, cause-effect diagrams for collaboration challenges #### ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘ Social learners - Present: Conference context with community discussion, cross-team collaboration examples - Improve: Peer learning cohorts for inner source adoption, community forums for sharing implementation experiences #### ๐Ÿง˜โ€โ™€๏ธ Solitary learners - Present: Self-assessment opportunities through maturity model, individual reflection prompts - Improve: Personal transformation workbooks, self-paced learning paths, private journaling exercises #### ๐ŸŒฟ Naturalistic learners - Present: Organizational ecosystem thinking, cultural transformation analogies - Improve: Systems thinking approach to collaboration, environmental impact of reduced duplicated work ### ๐Ÿ“Š Accessibility Assessment #### Screen reader semantics - Present: Clear heading structure in presentation slides, logical content flow - Improve: Alt text for diagrams, ARIA labels for interactive elements, descriptive link text #### Keyboard navigation - Present: Standard presentation navigation, logical tab order - Improve: Skip links for long content sections, keyboard shortcuts for framework navigation #### Contrast and readability - Present: Standard presentation contrast ratios - Improve: High-contrast mode options, adjustable text sizes for detailed framework content #### Text resizing and reflow - Present: Responsive design considerations - Improve: Text reflow at 200% zoom without horizontal scrolling, scalable diagram elements #### Media and captions - Present: Video presentation format - Improve: Complete transcript, audio descriptions for visual framework elements, downloadable materials #### Forms and interactions - Present: Basic interaction elements - Improve: Clear form labels for assessment tools, error handling for implementation checklists ### ๐ŸŒ DEIB Assessment #### Cultural breadth - Present: Global organization examples (27 offices), multi-region collaboration challenges - Improve: Diverse industry case studies, cultural considerations for governance models #### Inclusive language - Present: Gender-neutral technical terms, clear jargon definitions - Improve: Plain language alternatives for technical concepts, avoid culture-specific idioms #### Neurodiversity support - Present: Structured presentation format, clear section divisions - Improve --- ## Full Transcript [00:06] Hello everyone. Um, welcome to<br>[00:10] Inosource Berlin and uh, today I'll be<br>[00:13] speaking on scaling internal<br>[00:16] collaboration with opensource operating<br>[00:18] models.<br>[00:20] Sorry, I think I got the clicker.<br>[00:24] Yeah.<br>[00:28] All<br>[00:29] right.<br>[00:38] Okay. All right. So, a little about me.<br>[00:41] Um,<br>[00:47] so I'm IODG. Um, I'm a developer<br>[00:49] advocate at Ajin. um to endeavor and<br>[00:53] open source program office and uh seven<br>[00:57] years in software software development.<br>[00:59] I've been an open source advocate for a<br>[01:01] while and uh past community organizer at<br>[01:04] uh KCD Amsterdam and also Google<br>[01:07] developer groups uh WordPress meetups um<br>[01:11] Polygon<br>[01:13] and also I'm a proud proud dad of a<br>[01:15] seven month old.<br>[01:18] Yeah. So we're going to start uh quickly<br>[01:22] by looking at the the common challenges<br>[01:25] collaboration challenges in software<br>[01:27] development.<br>[01:28] Um so I'll start by maybe giving an<br>[01:31] example.<br>[01:33] How many of us here work as a solution<br>[01:35] engineer or consultants?<br>[01:38] A solution engineer.<br>[01:40] Yeah. How many of us here are<br>[01:42] developers?<br>[01:45] Okay. Yeah. So um the first scenario a<br>[01:49] sol solution engineer is attached to a<br>[01:52] company to help them on board to the<br>[01:54] platform. uh I work for a payment<br>[01:56] company so I'll say to to help them<br>[01:58] integrate their checkout or integrate<br>[02:00] their payments but um so every customer<br>[02:04] have different use case or sometimes<br>[02:07] have similar use case in those uh in<br>[02:11] those um collaboration the solution<br>[02:14] engineer probably have to build<br>[02:16] um an integration example for that<br>[02:19] customer to show how their platform<br>[02:22] works.<br>[02:24] Now the customer gets gets on boarded<br>[02:28] fine that's that's that's a success. So<br>[02:30] im imagine the same um the same role<br>[02:35] solution engineer for the same company<br>[02:38] in another region<br>[02:40] building the same type of application<br>[02:42] for for similar use cases. Now multiply<br>[02:46] this across several regions. At Adian we<br>[02:49] have about 27 offices globally.<br>[02:54] So this will probably amount to several<br>[02:58] duplicated projects similar projects in<br>[03:01] that lives in the laptop of of the<br>[03:03] solution engineer.<br>[03:06] Second scenario before I move to the<br>[03:08] challenges<br>[03:10] we're all engineers here and we probably<br>[03:13] assigned to build several projects<br>[03:14] internally. So imagine you were assigned<br>[03:17] to build um an internal internal duty<br>[03:21] roster that shows due uh duty time of of<br>[03:26] um team team members and you have to<br>[03:29] integrate with an internal service<br>[03:31] probably like that helps you get the<br>[03:34] LDAP of all your team members to display<br>[03:37] on that page. You go to the you first of<br>[03:40] all find it very hard to know who even<br>[03:42] owns the service. You look around<br>[03:44] internally, there is no documentation<br>[03:46] anywhere to on how to integrate with the<br>[03:48] LDAP service or even how to um integrate<br>[03:51] with the APIs. You go to the<br>[03:54] documentation page, nothing to write<br>[03:56] home about, no ownership, no one to<br>[03:59] reach out to. Okay, working with you<br>[04:02] successfully integrate with the LDAP. Uh<br>[04:05] and you found a bug, you opened a pull<br>[04:08] request, it took seven days before it<br>[04:11] gets merged. Now as an engineer this can<br>[04:14] be so frustrating and<br>[04:17] leading us to like<br>[04:20] the common collaboration challenges in<br>[04:22] software engineering. And the first one<br>[04:24] is unclear ownership.<br>[04:27] You see you land on the repo, you land<br>[04:30] on a service but you're not sure who<br>[04:32] wants the repo. You're not sure who to<br>[04:34] reach out to. That's one challenge. Then<br>[04:37] we have slow review. Of course,<br>[04:41] most of us here have gone through the<br>[04:42] same experience even working with open<br>[04:45] source projects.<br>[04:47] I've contributed to some open source<br>[04:50] projects. Um, and probably took two two<br>[04:54] years before I get the response from the<br>[04:56] maintainer. So, it's a very it's a big<br>[04:58] challenge in not just in open source but<br>[05:01] also internally as well. You get MR open<br>[05:04] for a while and no one to look at it or<br>[05:06] it's taking a while to get it merged.<br>[05:08] This can be frustrating.<br>[05:11] We also have duplicated work. So imagine<br>[05:14] the case of the solution engineer that<br>[05:16] has you know that is building that<br>[05:18] integration with the merchant but yeah<br>[05:21] ends up building the same type of<br>[05:23] integration over and over again because<br>[05:26] there is no inventory. There's no<br>[05:28] visibility on what projects even exist<br>[05:31] or what has already been done by someone<br>[05:33] else that you can build on top. And<br>[05:36] these are the challenges not not unique<br>[05:39] to inner source but also open source as<br>[05:41] well. The last one is limited<br>[05:44] visibility.<br>[05:47] Lack of visibility to what is available,<br>[05:50] lack of inventory of projects that have<br>[05:54] been done. It would definitely make um<br>[05:58] my life easy if I could just look at a<br>[06:02] look at an inventory or maybe uh a back<br>[06:05] backstage integration and see different<br>[06:08] projects different owners and I'm able<br>[06:10] to pick and get started with one project<br>[06:13] build on top of it help merchants on<br>[06:15] board or help customers on board even<br>[06:18] faster<br>[06:20] now like open source um inner source<br>[06:23] starts with the intention to share and<br>[06:25] collaborate. But yeah, when this is done<br>[06:31] in an unstructured way, then it still<br>[06:34] leads to the same problem. You have, you<br>[06:37] know, fragmented efforts, teams still<br>[06:40] build in silo. Even if you're<br>[06:42] collaborating, you still have projects<br>[06:45] that are built in silos. If you have a<br>[06:48] good project with good documentation<br>[06:50] without visibility, it's still the same<br>[06:53] uh still the same problem because first<br>[06:55] of all it needs to be discovered by<br>[06:57] other teammates before you can uh before<br>[06:59] they can even know how good the<br>[07:01] documentation or how they can interact<br>[07:03] with the with the service.<br>[07:07] Now this is how<br>[07:09] unstructured inner source looks like.<br>[07:12] different files, different projects.<br>[07:15] Although it's inner source, open source<br>[07:18] internally, everybody can see it, but<br>[07:21] still is still very unstructured and not<br>[07:23] organized.<br>[07:25] Now, we're going to look at open source.<br>[07:28] Open source has open source community<br>[07:30] has solved this problem a while back. If<br>[07:33] you look at the very standard opensource<br>[07:35] community, this problem is this is not a<br>[07:38] problem because it's been solved<br>[07:40] already. So, We're going to look at how<br>[07:43] we can design and scale collaboration<br>[07:47] using opensource models that are already<br>[07:49] available. So of course because inner<br>[07:52] source inner source is simply applying<br>[07:55] opensource practices internally. So<br>[07:58] we're going to look into that and with a<br>[08:00] goal of moving from building in silos<br>[08:04] practicing innerosource in silos to<br>[08:07] inner source culture<br>[08:11] let's look at the contribution part<br>[08:13] which<br>[08:15] I think is the first step<br>[08:17] looking at how to um design a well um<br>[08:22] predictable contribution path for uh for<br>[08:25] the internet teams and the first part is<br>[08:28] writing clear guidelines, writing clear<br>[08:30] policies. Policies are not just about<br>[08:34] um restricting access or restricting um<br>[08:37] or designing roadblocks.<br>[08:40] In fact, good policies, great policies,<br>[08:44] great policies looks like they don't<br>[08:45] exist because everyone already<br>[08:47] understands them. If you have a policy<br>[08:51] and your engineers still have to ask how<br>[08:54] do we deploy, how do we then probably<br>[08:56] you don't have a good policy. A good<br>[08:58] policy should be understandable and very<br>[09:02] predictable.<br>[09:04] We have the documentation aspect.<br>[09:08] Every projects make it um make it a<br>[09:12] policy that every project should have<br>[09:14] the proper documentation.<br>[09:18] good readadme not just readme but how to<br>[09:21] use it. If you go to a very standard<br>[09:24] open source project you see several<br>[09:26] markdown files explaining different<br>[09:28] things about the projects including the<br>[09:30] architecture of the project including<br>[09:32] how to contribute including how you know<br>[09:36] how the security uh structure of the<br>[09:38] project is is is implemented. So be<br>[09:42] heavy on documentation.<br>[09:45] Making sure every project that lives in<br>[09:47] your internal repo is well document is<br>[09:49] well documented.<br>[09:52] Now the third one is automation.<br>[09:55] Now they are very we are several<br>[09:58] organization that still have so many<br>[10:00] manual process.<br>[10:03] Try to automate things that can be<br>[10:06] automated.<br>[10:07] For instance,<br>[10:09] once the contribution is is open, once a<br>[10:12] MR is open, there should be a no is an<br>[10:16] automation in place to check the<br>[10:18] contribution to make sure not just the<br>[10:21] not just it's been um to make sure it's<br>[10:24] um it's properly done. You set up an<br>[10:27] automation to check um the the code<br>[10:30] itself, the code quality, to check the<br>[10:33] security. So those should be automated<br>[10:35] not just in open source but also also<br>[10:37] internally.<br>[10:39] You shouldn't have a scenario where<br>[10:41] where somebody or somewhere has to come<br>[10:44] and physically check or you know check<br>[10:47] the code to see if it's if it's<br>[10:49] compliant or not. This should be an<br>[10:51] automated process and the next steps<br>[10:54] should be like okay this is done we have<br>[10:56] this report it's fully compliant then<br>[10:59] let's merge then of course continuously<br>[11:03] improve this process as we evolve there<br>[11:07] will be<br>[11:09] better and better ways to do automation<br>[11:11] there will be better and better ways to<br>[11:12] do documentation<br>[11:14] continuously improve your process you<br>[11:17] shouldn't have for instance a<br>[11:19] documentation system that has been there<br>[11:21] for 20 years.<br>[11:24] Try to improve, try to advance to the uh<br>[11:28] latest and better way of doing<br>[11:30] documentation.<br>[11:33] We have you know cases in my company we<br>[11:36] have like documentation of se internal<br>[11:39] documentation of several pages and this<br>[11:42] documentation is built with a very old<br>[11:44] stack PHP<br>[11:46] and but yeah the good thing is that<br>[11:50] we're looking into upgrading that that<br>[11:53] documentation stack or even using a<br>[11:56] third party to make sure the<br>[11:57] documentation process is very very u<br>[12:00] simple and updating the documentation is<br>[12:02] very very um very straightforward.<br>[12:05] So continuous improvement is very<br>[12:08] important in the contribution part.<br>[12:10] Now the next part which is also taken<br>[12:14] from open source is governance.<br>[12:19] Have clear maintainers.<br>[12:21] Every project should have clear<br>[12:23] documentation of who owns what, who owns<br>[12:26] what service. If you if you have a<br>[12:28] project that's that has you know uh that<br>[12:31] has that is consuming other services<br>[12:35] design a clear maintenal graph that<br>[12:38] shows who owns what service and who to<br>[12:41] reach out to in in you know and how to<br>[12:44] reach out to them. We have several cases<br>[12:47] of um<br>[12:50] maintainers leaving the organization<br>[12:53] and the project dies.<br>[12:56] That shouldn't be the case. Declare, you<br>[12:58] know, design the maintainer graphs uh<br>[13:01] maintainer structure so as to enable<br>[13:04] sustainability of the projects. A<br>[13:07] project should not die when the owners<br>[13:09] go. Let's make sure it's properly um<br>[13:14] structured in a way that once anyone<br>[13:17] leaves there is also there's always<br>[13:19] someone else to reach out to and there<br>[13:21] was also there is always a continuous<br>[13:24] process for the projects so it doesn't<br>[13:26] become an abandoned project. This also<br>[13:28] affects open source. We see open source<br>[13:31] projects that the maintainers probably<br>[13:33] decide to stop maintaining the project<br>[13:36] and the project dies. That shouldn't be<br>[13:39] the case for your internal project.<br>[13:43] Then we have decision record.<br>[13:46] Make sure every decision you take for<br>[13:49] your project is properly recorded.<br>[13:53] In in my company we call it any decision<br>[13:55] record. In most company they call it<br>[13:58] architectural decision record. Make sure<br>[14:02] the service that people rely on,<br>[14:05] make sure it has decision records,<br>[14:09] you don't just um<br>[14:12] change the APIs or change how it's<br>[14:14] implemented. Everything should be<br>[14:16] properly recorded so that anyone<br>[14:18] depending on the project knows the<br>[14:20] timeline of the project, knows the the<br>[14:23] road map of the projects. Then review<br>[14:25] timeline. Make sure you have review<br>[14:29] timelines. So you set an expectation<br>[14:34] from your experience reviewing the code.<br>[14:36] From from your experience reviewing the<br>[14:38] project and approving PR, you should be<br>[14:40] able to tell this on average this is how<br>[14:42] long you could you could wait before<br>[14:44] your your project your PR is merged.<br>[14:47] Make this known to the user as well.<br>[14:51] Now now that we have the governance in<br>[14:54] place, we have the contribution path.<br>[14:57] Let's look at how we can scale it in the<br>[14:59] organization.<br>[15:01] So we have three principles we can<br>[15:02] borrow from the open source opensource<br>[15:04] program office. In some companies you<br>[15:06] already have a a standard open source<br>[15:09] program office. While in some companies,<br>[15:11] okay, you still your practice inner<br>[15:12] source without an open source program<br>[15:14] office. Fine. But these three principles<br>[15:16] still stands with or without open source<br>[15:19] program office. And this is compliance.<br>[15:21] Compliance here is not just about it's<br>[15:22] not about um license. Compliance is<br>[15:26] making sure<br>[15:28] um every project internally follows the<br>[15:31] same structure. So it's not just a team<br>[15:33] effort. It becomes an organizationwide<br>[15:36] effort. So make it a program internally<br>[15:39] that every project is compliant and<br>[15:42] communicate this properly. And also<br>[15:45] collaboration. Make collaboration one of<br>[15:47] your principles.<br>[15:49] So that team members know that by<br>[15:52] default<br>[15:53] they should look at other project. They<br>[15:55] should look at what is is what's what's<br>[15:57] in existence before reinventing the<br>[16:00] wheel. There's always some project there<br>[16:03] somebody has built that has solved the<br>[16:05] same issue that you want to build. Let<br>[16:08] there be a way to collaborate. Let there<br>[16:10] be a way to discover this. And most some<br>[16:12] companies do this by you know building a<br>[16:15] very structured metadata platforms in<br>[16:18] backstage or platforms that are used<br>[16:20] internally. Then also communication is<br>[16:23] very important<br>[16:26] making it a principle to always um<br>[16:29] communicate your changes. So this ties<br>[16:32] down to what we looked at in the uh<br>[16:34] decision record. So these three<br>[16:36] principles helps you to also scale um<br>[16:40] your inner source your collaboration<br>[16:42] internally.<br>[16:45] We look at uh the let's quickly look at<br>[16:48] the inner source maturity level in case<br>[16:49] you're trying to know okay where am I as<br>[16:51] a company where am I as an organization<br>[16:53] and how are these opensource operating<br>[16:55] models moving the collaboration from<br>[16:57] isolated to cultural<br>[16:59] we look at this<br>[17:02] now this is adapted from the inner<br>[17:04] source commons<br>[17:06] the first of course stage is where<br>[17:08] everything is isolated that is where we<br>[17:10] have zero inner source culture where we<br>[17:12] have zero collaboration culture then we<br>[17:14] have the emerging you already know that<br>[17:16] there's inner source you're already u<br>[17:18] somebody in your team already suggested<br>[17:20] okay let's practice inner source and<br>[17:22] probably one or two repos have been made<br>[17:24] open to everyone documentation are being<br>[17:27] worked on this is the adoption phase<br>[17:29] then we have the structured phase where<br>[17:32] one or two teams are practicing<br>[17:34] innerosource<br>[17:36] very well and they have they you know<br>[17:40] they have a a good example of how what<br>[17:43] an inner practice should look like. Then<br>[17:46] of course the fourth one is when<br>[17:49] Innosource is scaled across your<br>[17:52] organization. Innosource becomes a<br>[17:55] culture. Collaboration becomes a<br>[17:57] culture. By default, engineers look at<br>[18:00] ways to collaborate more in the<br>[18:02] organization.<br>[18:03] So your goal should be from getting from<br>[18:06] wherever you are in this stage to the<br>[18:09] inner source culture.<br>[18:13] How do we measure impact<br>[18:15] on deep devx?<br>[18:18] You know, we talk about inner source and<br>[18:20] if we want to probably tell the<br>[18:23] leadership, let's do innerosource, but<br>[18:25] how do we measure impact? How do you<br>[18:27] know these collaboration efforts are<br>[18:28] working?<br>[18:32] One of them is onboarding time.<br>[18:35] If you look at a project, how long will<br>[18:37] it take a developer to pick up that<br>[18:39] service or pick up that project or pick<br>[18:41] up that API and interact with the API or<br>[18:44] integrate with the API. How long does it<br>[18:46] take? You measure before and after. This<br>[18:49] should show some metrics that your inner<br>[18:51] source is working. Then review<br>[18:53] turnaround. How long does it take for<br>[18:55] PRs to get merged?<br>[18:59] Then we have cross team contributions.<br>[19:03] How many contributions in your projects<br>[19:05] are coming in in projects are coming<br>[19:07] from other teams.<br>[19:09] So this is also another uh metrics and<br>[19:12] also reuse rates. How many um part of a<br>[19:17] project is reused or is part of another<br>[19:22] service.<br>[19:24] Look at all the projects and look at how<br>[19:27] many pieces are they and how many are<br>[19:29] coming from different projects. How many<br>[19:30] are coming from different teams.<br>[19:33] I believe this should increase when<br>[19:35] inner sauceource or this should change<br>[19:37] when innerource is prop is practiced<br>[19:39] properly<br>[19:42] then yeah let's look at the quick<br>[19:44] takeaways of this talk and one of them<br>[19:47] is design predictable<br>[19:49] predictable parts contribution parts<br>[19:52] build lightweight governance that builds<br>[19:54] trust apply orwide shared principles for<br>[19:58] consistency and flow and of course<br>[20:00] measure the impact always measure the<br>[20:03] impact because this is where you're able<br>[20:05] to convince leadership that what you're<br>[20:08] doing is working.<br>[20:11] Where do you start? Start from where you<br>[20:13] are and have the vision to be an<br>[20:18] innocriven<br>[20:20] culture.<br>[20:23] Thank you. <!-- deep-read:sections end --> ## ๐Ÿ“บ Video ![](https://www.youtube.com/watch?v=ggF3fIT5lh8) --- # ๐Ÿ“ Full Notes (Deep-Read Analysis) # ๐Ÿท๏ธ Title: Scaling Internal Collaboration with Open Source Operating Models ## ๐Ÿงฐ Action Inbox - [H1] Audit current projects for clear maintainer documentation โ€” eliminate ownership ambiguity #governance - [H2] Establish review timeline SLAs and communicate expectations โ€” reduce PR frustration #process - [H3] Implement project discovery system to prevent duplicated work โ€” increase reuse metrics #visibility ## ๐Ÿงญ Table of Contents - [๐Ÿ“ Summary](#-summary) - [๐Ÿ“– Main Content](#-main-content) - [๐Ÿ—’๏ธ Notes](#๏ธ-notes) - [๐Ÿ“š References](#-references) - [๐Ÿ—ฃ๏ธ Paraphrase](#๏ธ-paraphrase) - [๐Ÿ“ฐ Newsletter](#-newsletter) - [โœ… Action Items](#-action-items) - [๐Ÿงช Hypotheses](#-hypotheses) - [๐Ÿ“Š Methodology](#-methodology) - [โ“ Questions](#-questions) - [๐Ÿ”ฎ Future Research](#-future-research) - [๐Ÿ’ก Implications](#-implications) - [๐Ÿง  Learning Styles Assessment](#-learning-styles-assessment) - [๐Ÿ“Š Accessibility Assessment](#-accessibility-assessment) - [๐ŸŒ DEIB Assessment](#-deib-assessment) - [โœ… Logical Validity](#-logical-validity) - [๐Ÿ›ก๏ธ DARVO Analysis](#-darvo-analysis) - [๐ŸŽฏ Conclusion](#-conclusion) ### ๐Ÿ”— References - [InnerSource Commons](https://innersourcecommons.org/) - [Open Source Program Office](https://todogroup.org/) ## ๐Ÿ“ Summary - **What happened**: Developer advocate presents framework for scaling internal collaboration using open source operating models at InnerSource Summit Berlin - **Why it matters**: Organizations face duplicated work, unclear ownership, slow reviews, and limited visibility across teams - **Key stakeholders**: Engineering teams, solution engineers, OSPOs, and technical leadership - **Risks and tradeoffs**: Requires organizational commitment to process change and cultural shift from isolated to collaborative work - **Bottom line**: Apply proven open source practices internally through structured contribution paths, governance, and organization-wide principles ## ๐Ÿ“– Main Content The presentation addresses common collaboration challenges in software development that plague both internal teams and open source projects: unclear ownership, slow review cycles, duplicated work, and limited project visibility. The speaker uses examples from their payment company experience, noting how solution engineers across 27 global offices often build identical integration examples independently. **Core Framework Components:** 1. **Contribution Path Design**: Clear guidelines, heavy documentation, automation, and continuous improvement 2. **Governance Structure**: Clear maintainers, sustainability planning, decision records, and review timelines 3. **Scaling Principles**: Compliance (consistent structure), collaboration (discovery before building), and communication (transparent change management) The maturity model progresses from isolated work through emerging awareness, structured adoption, to full cultural transformation where collaboration becomes default behavior. **Measurement Strategy**: Track onboarding time, review turnaround, cross-team contributions, and reuse rates to demonstrate impact and secure leadership buy-in. ## ๐Ÿ—’๏ธ Notes #### โฑ๏ธ [00:00](https://youtu.be/ggF3fIT5lh8?t=0) โ€” [H1] Introduction and speaker background - Key idea: Developer advocate at payment company with OSPO experience and community organizing background - Evidence: "Seven years in software development, open source advocate, past community organizer" #### โฑ๏ธ [02:15](https://youtu.be/ggF3fIT5lh8?t=135) โ€” [H2] Solution engineer duplication problem - Key idea: Global teams unknowingly build identical integration examples for similar customer use cases - Evidence: "At Adyen we have about 27 offices globally, probably amounts to several duplicated projects in laptops of solution engineers" #### โฑ๏ธ [03:45](https://youtu.be/ggF3fIT5lh8?t=225) โ€” [H2] Internal service integration frustrations - Key idea: Engineers struggle with undocumented internal services and unclear ownership - Evidence: "Find it very hard to know who owns the service, no documentation on how to integrate with LDAP APIs" #### โฑ๏ธ [05:30](https://youtu.be/ggF3fIT5lh8?t=330) โ€” [H1] Four common collaboration challenges - Key idea: Unclear ownership, slow reviews, duplicated work, and limited visibility plague internal development - Evidence: "Seven days before PR gets merged, can be so frustrating for engineers" #### โฑ๏ธ [07:15](https://youtu.be/ggF3fIT5lh8?t=435) โ€” [H2] Unstructured inner source still creates problems - Key idea: Simply making repositories internally visible doesn't solve collaboration issues without organization - Evidence: "Fragmented efforts, teams still build in silos, projects built in silos even if collaborating" #### โฑ๏ธ [08:45](https://youtu.be/ggF3fIT5lh8?t=525) โ€” [H1] Open source communities already solved these problems - Key idea: Standard open source practices provide proven models for internal collaboration - Evidence: "Open source community has solved this problem a while back, very standard community" #### โฑ๏ธ [10:00](https://youtu.be/ggF3fIT5lh8?t=600) โ€” [H1] Designing predictable contribution paths - Key idea: Clear guidelines, documentation, automation, and continuous improvement enable smooth contributions - Evidence: "Good policies look like they don't exist because everyone already understands them" #### โฑ๏ธ [12:30](https://youtu.be/ggF3fIT5lh8?t=750) โ€” [H2] Documentation requirements for every project - Key idea: Every internal project needs comprehensive documentation beyond basic README files - Evidence: "Several markdown files explaining architecture, contribution process, security structure implementation" #### โฑ๏ธ [13:45](https://youtu.be/ggF3fIT5lh8?t=825) โ€” [H2] Automation over manual processes - Key idea: Automate code quality, security checks, and compliance rather than manual reviews - Evidence: "Shouldn't have scenario where somebody physically checks code compliance, should be automated process" #### โฑ๏ธ [15:15](https://youtu.be/ggF3fIT5lh8?t=915) โ€” [H1] Governance through clear maintainers - Key idea: Document ownership clearly and plan for maintainer succession to prevent abandoned projects - Evidence: "Project should not die when owners leave, always someone else to reach out to" #### โฑ๏ธ [16:30](https://youtu.be/ggF3fIT5lh8?t=990) โ€” [H2] Decision records and review timelines - Key idea: Document all architectural decisions and set clear expectations for review cycles - Evidence: "From experience reviewing projects, you should tell users how long they wait before PR merged" #### โฑ๏ธ [18:00](https://youtu.be/ggF3fIT5lh8?t=1080) โ€” [H1] Three scaling principles from OSPO - Key idea: Compliance, collaboration, and communication enable organization-wide adoption - Evidence: "Make collaboration a principle so team members look at other projects before reinventing wheel" #### โฑ๏ธ [20:00](https://youtu.be/ggF3fIT5lh8?t=1200) โ€” [H2] Inner source maturity levels - Key idea: Organizations progress from isolated work through emerging adoption to cultural transformation - Evidence: "Goal should be getting from wherever you are to inner source culture where collaboration becomes default" #### โฑ๏ธ [21:30](https://youtu.be/ggF3fIT5lh8?t=1290) โ€” [H1] Measuring developer experience impact - Key idea: Track onboarding time, review turnaround, cross-team contributions, and reuse rates - Evidence: "How long does it take developer to pick up API and integrate? Measure before and after" #### โฑ๏ธ [23:00](https://youtu.be/ggF3fIT5lh8?t=1380) โ€” [H1] Key takeaways and starting point - Key idea: Design predictable paths, build lightweight governance, apply shared principles, and measure impact - Evidence: "Start from where you are and have vision to be inner source driven culture" ## ๐Ÿ“š References - [InnerSource Commons](https://innersourcecommons.org/) - [TODO Group OSPO Guide](https://todogroup.org/) - [Backstage Software Catalog](https://backstage.io/) ## ๐Ÿ—ฃ๏ธ Paraphrase - Organizations waste resources when teams unknowingly duplicate work across regions and departments due to poor project visibility and discovery mechanisms - Internal development suffers from the same collaboration problems as poorly managed open source projects: unclear ownership, slow feedback cycles, and fragmented efforts - Applying proven open source governance models internallyโ€”clear contribution paths, documented ownership, automated processesโ€”transforms isolated work into collaborative culture ## ๐Ÿ“ฐ Newsletter **Transform Internal Collaboration with Open Source Practices** Tired of teams building the same solutions in isolation? A compelling presentation from InnerSource Summit Berlin shows how to scale collaboration using proven open source operating models. The key insight: internal development faces identical challenges to poorly managed open source projectsโ€”unclear ownership, slow reviews, duplicated work, and limited visibility. The solution isn't just making repositories internally visible, but applying structured open source practices. **Three-Part Framework:** - **Contribution Paths**: Clear guidelines, comprehensive documentation, automated checks - **Governance**: Documented maintainers, decision records, review timelines - **Scaling Principles**: Organization-wide compliance, collaboration-first culture, transparent communication Track success through onboarding time, review turnaround, cross-team contributions, and reuse rates to demonstrate impact to leadership. Ready to move from building in silos to collaborative culture? Start where you are and apply these time-tested open source practices internally. Resources: [InnerSource Commons](https://innersourcecommons.org/), [OSPO Guide](https://todogroup.org/), [Backstage](https://backstage.io/) ## โœ… Action Items #### DevRel - Developer experience: Audit internal project documentation gaps, create contribution path templates - Education: Design workshops on inner source best practices, establish office hours for collaboration questions - Developer marketing: Create case studies showcasing successful cross-team collaborations and reuse metrics - Community management: Set up internal forums for project discovery, moderate cross-team collaboration discussions #### OSPO - Policy & Governance: Develop internal project compliance standards, create maintainer succession templates - Software Inventory: Implement project discovery platform, track cross-team dependencies and reuse rates - Developer Support: Provide inner source tooling training, create automated compliance checking tools - Strategic Alignment: Establish KPIs for collaboration culture, measure onboarding time and review turnaround improvements #### Community - Maintainers: Create ownership documentation standards, establish review timeline SLAs and succession planning - Contributors: Design onboarding paths for cross-team contributions, implement first-issue programs for internal projects - Ecosystem: Build project discovery mechanisms, coordinate cross-team integration standards #### WordPress - Core: Apply inner source principles to core contribution workflows, improve maintainer succession planning - Documentation: Audit DevHub and HelpHub for ownership clarity, establish review timeline expectations - Community: Create inner source best practices guides for meetup organizers and WordCamp contributors - Meta: Implement project discovery features on .org infrastructure, track cross-team collaboration metrics #### The WPCC - Programs: Design inner source fellowship programs, provide microgrants for cross-organization collaboration tools - Projects: Run governance clinics teaching inner source principles, fund documentation sprints for internal projects #### FAIR - Technical independence: Ensure inner source practices don't create vendor lock-in, maintain metadata portability - Governance artifacts: Create inner source policy templates, establish operator agreements for shared internal infrastructure ## ๐Ÿงช Hypotheses - Teams with clear maintainer documentation and review timelines will show measurably faster onboarding times compared to projects with unclear ownership - Organizations implementing automated compliance checking will see increased cross-team contribution rates within six months - Project discovery platforms will reduce duplicated work by 40% when combined with collaboration-first cultural principles - Inner source maturity progression correlates with improved developer satisfaction scores and reduced time-to-market metrics ### ๐Ÿ“Š Methodology - Study design: Compare onboarding times, review turnaround, and cross-team contributions before/after inner source implementation across multiple organizations - Data sources: Git analytics, developer surveys, project metadata, and collaboration platform metrics - Experiments: A/B test different governance models and measure impact on reuse rates and developer experience ### โ“ Questions - How do we balance governance overhead with development velocity in fast-moving organizations? - What specific automation tools most effectively reduce manual review burden while maintaining code quality? - How can organizations measure and incentivize cultural transformation toward collaboration-first mindsets? ### ๐Ÿ”ฎ Future Research - Long-term impact studies on inner source adoption across different organizational sizes and cultures - Integration patterns between inner source practices and existing DevOps toolchains and CI/CD pipelines - Cross-industry comparison of inner source maturity models and their effectiveness in different business contexts ### ๐Ÿ’ก Implications - **Practice**: Teams need structured approaches to transition from ad-hoc sharing to systematic inner source practices - **Policy**: Organizations require governance frameworks that enable rather than restrict internal collaboration - **Education**: Developer education must include collaboration skills and open source practices, not just technical implementation - **Funding**: Budget allocation should account for tooling, process development, and cultural change management in inner source initiatives ### ๐Ÿง  Learning Styles Assessment Reading level estimate: Flesch-Kincaid Grade Level 12 #### ๐Ÿ‘€ Visual learners - Present: Maturity level diagram, organizational structure examples - Improve: Process flow diagrams, before/after collaboration visualizations, governance structure charts #### ๐Ÿ”Š Aural learners - Present: Conference presentation format with clear verbal explanations - Improve: Audio summary of key frameworks, podcast-style discussion of implementation challenges #### ๐Ÿ—ฃ๏ธ Verbal learners - Present: Clear definitions of inner source terms, analogies to open source practices - Improve: Storytelling around transformation examples, comparison frameworks between traditional and inner source approaches #### ๐Ÿงฉ Kinesthetic learners - Present: Step-by-step implementation guidance, actionable takeaways - Improve: Hands-on workshops for governance setup, interactive maturity assessment tools, practical templates #### ๐Ÿง  Logical learners - Present: Structured three-part framework, clear progression through maturity levels - Improve: Decision trees for governance choices, metrics dashboards, cause-effect diagrams for collaboration challenges #### ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘ Social learners - Present: Conference context with community discussion, cross-team collaboration examples - Improve: Peer learning cohorts for inner source adoption, community forums for sharing implementation experiences #### ๐Ÿง˜โ€โ™€๏ธ Solitary learners - Present: Self-assessment opportunities through maturity model, individual reflection prompts - Improve: Personal transformation workbooks, self-paced learning paths, private journaling exercises #### ๐ŸŒฟ Naturalistic learners - Present: Organizational ecosystem thinking, cultural transformation analogies - Improve: Systems thinking approach to collaboration, environmental impact of reduced duplicated work ### ๐Ÿ“Š Accessibility Assessment #### Screen reader semantics - Present: Clear heading structure in presentation slides, logical content flow - Improve: Alt text for diagrams, ARIA labels for interactive elements, descriptive link text #### Keyboard navigation - Present: Standard presentation navigation, logical tab order - Improve: Skip links for long content sections, keyboard shortcuts for framework navigation #### Contrast and readability - Present: Standard presentation contrast ratios - Improve: High-contrast mode options, adjustable text sizes for detailed framework content #### Text resizing and reflow - Present: Responsive design considerations - Improve: Text reflow at 200% zoom without horizontal scrolling, scalable diagram elements #### Media and captions - Present: Video presentation format - Improve: Complete transcript, audio descriptions for visual framework elements, downloadable materials #### Forms and interactions - Present: Basic interaction elements - Improve: Clear form labels for assessment tools, error handling for implementation checklists ### ๐ŸŒ DEIB Assessment #### Cultural breadth - Present: Global organization examples (27 offices), multi-region collaboration challenges - Improve: Diverse industry case studies, cultural considerations for governance models #### Inclusive language - Present: Gender-neutral technical terms, clear jargon definitions - Improve: Plain language alternatives for technical concepts, avoid culture-specific idioms #### Neurodiversity support - Present: Structured presentation format, clear section divisions - Improve --- # ๐Ÿ“„ Full Transcript *Auto-generated from YouTube captions ยท timestamps roughly every 30 seconds ยท [watch on YouTube](https://www.youtube.com/watch?v=ggF3fIT5lh8)* **[00:06]** Hello everyone. Um, welcome to Inosource Berlin and uh, today I'll be speaking on scaling internal collaboration with opensource operating models. Sorry, I think I got the clicker. Yeah. All right. **[00:38]** Okay. All right. So, a little about me. Um, so I'm IODG. Um, I'm a developer advocate at Ajin. um to endeavor and open source program office and uh seven years in software software development. I've been an open source advocate for a while and uh past community organizer at uh KCD Amsterdam and also Google developer groups uh WordPress meetups um **[01:11]** Polygon and also I'm a proud proud dad of a seven month old. Yeah. So we're going to start uh quickly by looking at the the common challenges collaboration challenges in software development. Um so I'll start by maybe giving an example. How many of us here work as a solution engineer or consultants? A solution engineer. Yeah. How many of us here are **[01:42]** developers? Okay. Yeah. So um the first scenario a sol solution engineer is attached to a company to help them on board to the platform. uh I work for a payment company so I'll say to to help them integrate their checkout or integrate their payments but um so every customer have different use case or sometimes have similar use case in those uh in those um collaboration the solution **[02:14]** engineer probably have to build um an integration example for that customer to show how their platform works. Now the customer gets gets on boarded fine that's that's that's a success. So im imagine the same um the same role solution engineer for the same company in another region building the same type of application for for similar use cases. Now multiply **[02:46]** this across several regions. At Adian we have about 27 offices globally. So this will probably amount to several duplicated projects similar projects in that lives in the laptop of of the solution engineer. Second scenario before I move to the challenges we're all engineers here and we probably assigned to build several projects internally. So imagine you were assigned **[03:17]** to build um an internal internal duty roster that shows due uh duty time of of um team team members and you have to integrate with an internal service probably like that helps you get the LDAP of all your team members to display on that page. You go to the you first of all find it very hard to know who even owns the service. You look around internally, there is no documentation anywhere to on how to integrate with the **[03:48]** LDAP service or even how to um integrate with the APIs. You go to the documentation page, nothing to write home about, no ownership, no one to reach out to. Okay, working with you successfully integrate with the LDAP. Uh and you found a bug, you opened a pull request, it took seven days before it gets merged. Now as an engineer this can be so frustrating and leading us to like **[04:20]** the common collaboration challenges in software engineering. And the first one is unclear ownership. You see you land on the repo, you land on a service but you're not sure who wants the repo. You're not sure who to reach out to. That's one challenge. Then we have slow review. Of course, most of us here have gone through the same experience even working with open source projects. I've contributed to some open source projects. Um, and probably took two two **[04:54]** years before I get the response from the maintainer. So, it's a very it's a big challenge in not just in open source but also internally as well. You get MR open for a while and no one to look at it or it's taking a while to get it merged. This can be frustrating. We also have duplicated work. So imagine the case of the solution engineer that has you know that is building that integration with the merchant but yeah ends up building the same type of integration over and over again because **[05:26]** there is no inventory. There's no visibility on what projects even exist or what has already been done by someone else that you can build on top. And these are the challenges not not unique to inner source but also open source as well. The last one is limited visibility. Lack of visibility to what is available, lack of inventory of projects that have been done. It would definitely make um **[05:58]** my life easy if I could just look at a look at an inventory or maybe uh a back backstage integration and see different projects different owners and I'm able to pick and get started with one project build on top of it help merchants on board or help customers on board even faster now like open source um inner source starts with the intention to share and collaborate. But yeah, when this is done **[06:31]** in an unstructured way, then it still leads to the same problem. You have, you know, fragmented efforts, teams still build in silo. Even if you're collaborating, you still have projects that are built in silos. If you have a good project with good documentation without visibility, it's still the same uh still the same problem because first of all it needs to be discovered by other teammates before you can uh before they can even know how good the **[07:01]** documentation or how they can interact with the with the service. Now this is how unstructured inner source looks like. different files, different projects. Although it's inner source, open source internally, everybody can see it, but still is still very unstructured and not organized. Now, we're going to look at open source. Open source has open source community has solved this problem a while back. If **[07:33]** you look at the very standard opensource community, this problem is this is not a problem because it's been solved already. So, We're going to look at how we can design and scale collaboration using opensource models that are already available. So of course because inner source inner source is simply applying opensource practices internally. So we're going to look into that and with a goal of moving from building in silos **[08:04]** practicing innerosource in silos to inner source culture let's look at the contribution part which I think is the first step looking at how to um design a well um predictable contribution path for uh for the internet teams and the first part is writing clear guidelines, writing clear policies. Policies are not just about **[08:34]** um restricting access or restricting um or designing roadblocks. In fact, good policies, great policies, great policies looks like they don't exist because everyone already understands them. If you have a policy and your engineers still have to ask how do we deploy, how do we then probably you don't have a good policy. A good policy should be understandable and very predictable. **[09:04]** We have the documentation aspect. Every projects make it um make it a policy that every project should have the proper documentation. good readadme not just readme but how to use it. If you go to a very standard open source project you see several markdown files explaining different things about the projects including the architecture of the project including how to contribute including how you know **[09:36]** how the security uh structure of the project is is is implemented. So be heavy on documentation. Making sure every project that lives in your internal repo is well document is well documented. Now the third one is automation. Now they are very we are several organization that still have so many manual process. Try to automate things that can be automated. **[10:07]** For instance, once the contribution is is open, once a MR is open, there should be a no is an automation in place to check the contribution to make sure not just the not just it's been um to make sure it's um it's properly done. You set up an automation to check um the the code itself, the code quality, to check the security. So those should be automated not just in open source but also also internally. **[10:39]** You shouldn't have a scenario where where somebody or somewhere has to come and physically check or you know check the code to see if it's if it's compliant or not. This should be an automated process and the next steps should be like okay this is done we have this report it's fully compliant then let's merge then of course continuously improve this process as we evolve there will be better and better ways to do automation **[11:11]** there will be better and better ways to do documentation continuously improve your process you shouldn't have for instance a documentation system that has been there for 20 years. Try to improve, try to advance to the uh latest and better way of doing documentation. We have you know cases in my company we have like documentation of se internal documentation of several pages and this **[11:42]** documentation is built with a very old stack PHP and but yeah the good thing is that we're looking into upgrading that that documentation stack or even using a third party to make sure the documentation process is very very u simple and updating the documentation is very very um very straightforward. So continuous improvement is very important in the contribution part. Now the next part which is also taken **[12:14]** from open source is governance. Have clear maintainers. Every project should have clear documentation of who owns what, who owns what service. If you if you have a project that's that has you know uh that has that is consuming other services design a clear maintenal graph that shows who owns what service and who to reach out to in in you know and how to **[12:44]** reach out to them. We have several cases of um maintainers leaving the organization and the project dies. That shouldn't be the case. Declare, you know, design the maintainer graphs uh maintainer structure so as to enable sustainability of the projects. A project should not die when the owners go. Let's make sure it's properly um structured in a way that once anyone **[13:17]** leaves there is also there's always someone else to reach out to and there was also there is always a continuous process for the projects so it doesn't become an abandoned project. This also affects open source. We see open source projects that the maintainers probably decide to stop maintaining the project and the project dies. That shouldn't be the case for your internal project. Then we have decision record. Make sure every decision you take for **[13:49]** your project is properly recorded. In in my company we call it any decision record. In most company they call it architectural decision record. Make sure the service that people rely on, make sure it has decision records, you don't just um change the APIs or change how it's implemented. Everything should be properly recorded so that anyone depending on the project knows the **[14:20]** timeline of the project, knows the the road map of the projects. Then review timeline. Make sure you have review timelines. So you set an expectation from your experience reviewing the code. From from your experience reviewing the project and approving PR, you should be able to tell this on average this is how long you could you could wait before your your project your PR is merged. Make this known to the user as well. **[14:51]** Now now that we have the governance in place, we have the contribution path. Let's look at how we can scale it in the organization. So we have three principles we can borrow from the open source opensource program office. In some companies you already have a a standard open source program office. While in some companies, okay, you still your practice inner source without an open source program office. Fine. But these three principles still stands with or without open source program office. And this is compliance. Compliance here is not just about it's **[15:22]** not about um license. Compliance is making sure um every project internally follows the same structure. So it's not just a team effort. It becomes an organizationwide effort. So make it a program internally that every project is compliant and communicate this properly. And also collaboration. Make collaboration one of your principles. So that team members know that by default **[15:53]** they should look at other project. They should look at what is is what's what's in existence before reinventing the wheel. There's always some project there somebody has built that has solved the same issue that you want to build. Let there be a way to collaborate. Let there be a way to discover this. And most some companies do this by you know building a very structured metadata platforms in backstage or platforms that are used internally. Then also communication is very important **[16:26]** making it a principle to always um communicate your changes. So this ties down to what we looked at in the uh decision record. So these three principles helps you to also scale um your inner source your collaboration internally. We look at uh the let's quickly look at the inner source maturity level in case you're trying to know okay where am I as a company where am I as an organization and how are these opensource operating models moving the collaboration from **[16:57]** isolated to cultural we look at this now this is adapted from the inner source commons the first of course stage is where everything is isolated that is where we have zero inner source culture where we have zero collaboration culture then we have the emerging you already know that there's inner source you're already u somebody in your team already suggested okay let's practice inner source and probably one or two repos have been made open to everyone documentation are being worked on this is the adoption phase **[17:29]** then we have the structured phase where one or two teams are practicing innerosource very well and they have they you know they have a a good example of how what an inner practice should look like. Then of course the fourth one is when Innosource is scaled across your organization. Innosource becomes a culture. Collaboration becomes a culture. By default, engineers look at **[18:00]** ways to collaborate more in the organization. So your goal should be from getting from wherever you are in this stage to the inner source culture. How do we measure impact on deep devx? You know, we talk about inner source and if we want to probably tell the leadership, let's do innerosource, but how do we measure impact? How do you know these collaboration efforts are working? **[18:32]** One of them is onboarding time. If you look at a project, how long will it take a developer to pick up that service or pick up that project or pick up that API and interact with the API or integrate with the API. How long does it take? You measure before and after. This should show some metrics that your inner source is working. Then review turnaround. How long does it take for PRs to get merged? Then we have cross team contributions. **[19:03]** How many contributions in your projects are coming in in projects are coming from other teams. So this is also another uh metrics and also reuse rates. How many um part of a project is reused or is part of another service. Look at all the projects and look at how many pieces are they and how many are coming from different projects. How many are coming from different teams. **[19:33]** I believe this should increase when inner sauceource or this should change when innerource is prop is practiced properly then yeah let's look at the quick takeaways of this talk and one of them is design predictable predictable parts contribution parts build lightweight governance that builds trust apply orwide shared principles for consistency and flow and of course measure the impact always measure the impact because this is where you're able **[20:05]** to convince leadership that what you're doing is working. Where do you start? Start from where you are and have the vision to be an innocriven culture. Thank you.