Skip to Main Content
Workshop Beginner First Talk

Beyond the Code: Designing Contributor Experience in Open Source

Proposal status is Rejected
Session Description

Open Source is a Product Too

Every open source project has two products: the software itself and the experience of contributing to it.

The first interaction with a project is rarely writing code. It is reading a README, understanding the documentation, finding a beginner-friendly issue, setting up the development environment, or receiving the first pull request review. These moments shape whether someone becomes a long-term contributor or quietly leaves.

As AI lowers the barrier to writing code, the challenge has shifted from implementation to understanding context. Projects with clear onboarding, discoverable documentation, and contributor-friendly workflows are more likely to grow healthy communities than those that rely solely on technical excellence.

This talk explores contributor experience through the lens of product design. Using examples from well-known open source projects such as Penpot, AsyncAPI, Open WebUI, and First Contributions, we will break down the design decisions that reduce friction and encourage participation.

Rather than discussing visual design, the session focuses on practical improvements that any maintainer can make without adding a designer to the team.

What we'll cover

The contributor journey

We'll map the experience of a first-time contributor, from discovering a repository to getting their first pull request merged. We'll identify common points where contributors lose confidence or drop off, and discuss why these moments matter.

Product thinking for maintainers

We'll look at familiar project assets such as READMEs, documentation, issue boards, pull request templates, and error messages as product touchpoints. Through before-and-after examples, we'll explore how small changes improve clarity and reduce contributor effort.

Patterns from successful open source communities

We'll study contribution workflows from established projects to understand recurring patterns that make them approachable. Topics include progressive onboarding, issue discoverability, documentation structure, review feedback, and communication practices.

AI and the future of contributor experience

Developers increasingly rely on AI assistants to understand projects, navigate documentation, and generate code. We'll discuss how better project structure, documentation, and examples improve not only the experience for contributors but also the quality of AI-assisted development.

Key takeaways

Attendees will leave with a practical framework they can immediately apply to their own projects.

  • Learn how to identify friction in contributor onboarding before it impacts community growth.

  • Apply simple product design principles to improve documentation, issue management, pull request workflows, and project communication.

  • Understand how successful open source projects reduce uncertainty through thoughtful contributor experience rather than additional complexity.

  • Learn how AI-assisted development changes expectations around documentation and project structure.

  • Take home a Contributor Experience Checklist to evaluate and improve any open source repository, regardless of its size or technology stack.

This session is intended for maintainers, contributors, developers, founders, and designers who want to build open source projects that are easier to understand, easier to contribute to, and easier to sustain.

Key Takeaways


Takeaways
By the end of the session, attendees will be able to:

  • Evaluate their project's contributor experience beyond the code, from discovery to the first merged pull request.

  • Identify common friction points in onboarding, documentation, issue management, and code review using real examples from successful open source projects.

  • Apply five practical product design principles to improve contributor experience without requiring a dedicated design team.

  • Structure documentation and project workflows that work better for both human contributors and AI-assisted development.

  • Take home a Contributor Experience Checklist that can be used to audit and improve any open source repository.

References

Session Categories

Other
Community

Which track are you applying for?

Open Design

Speakers

Nandini Kataria
Nandini Kataria Product designer | frog design, India

Nandini Kataria is a Product Designer at frog, India with over 3 years of experience designing for AI, enterprise, public sector, and consumer products. She enjoys building at the intersection of design and technology, and where open source and design collide, and in making that intersection easier for designers to step into.

Portfolio: https://nandinikatariaworks.framer.website