Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Embracing Openness in Open Source

Embracing Openness in Open Source

This is the story of how I struggled to get my first tech role and turned to Open Source projects looking for help. We’ll learn how the best GitHub repos are attracting new contributors, why developers early in their coding journey can struggle to get to grips with a new repo and how you avoid these stumbling blocks to create a vibrant open source project.


Amina Adewusi

July 05, 2019


  1. Embracing Openness in Open Source Amina Adewusi Brighton Ruby 2019

  2. Hi, I’m Amina

  3. None
  4. 2018 GitHub contributions First PR!

  5. @MikeMcQuaid’s contributor funnel

  6. 95% male GitHub 2018 Octoverse 92% male Stack Overflow 2019

    https://octoverse.github.com/ https://insights.stackoverflow.com/survey/2019
  7. Documentation & Friendliness

  8. ? Under-represented groups / First-time contributors /Non - contributors

  9. Language at critical points in the first-timer user journey

  10. https://github.com/rubyforgood/diaper/issues?q=is%3Aopen+is%3Aissue+label%3A%22Good+First+Issue%22

  11. None
  12. Summary • Language • Issues • Public forums

  13. “...too often people feel unwelcome, unheard, and unable to help

    or to find help, particularly women, people of color, and other underrepresented groups. This has to change, and it starts with us...So in 2019 we’re going to be redoubling our efforts” David Fullerton, Stack Overflow President and Chief Technology Officer https://stackoverflow.blog/2019/01/18/state-of-the-stack-2019-a-year-in-review/?_ga=2.265385423.1553455204.1561780259-235477409.1533927163
  14. Appendices 1. Guides to creating repos open to first-timers 2.

    Repos celebrated for welcoming first-timers 3. Support for people new to open source 4. Research on open source participation 5. Articles on the challenges of being an active contributor and maintainer
  15. Thank you • Global CFP Day • Daniel Appelquist, Samsung

    Developer Advocate & W3C committee member • Eddie Jaoude, Open Source Advocate • Jeffrey Warren, Publiclabs • Joe Nash, ex GitHub • Bryan Warren and Anna Filippova, GitHub • Mikeal Rogers and Rich Trott, Node.js Foundation • Chase Southard, Director of Engineering at Xometry • Rob Whittaker, Director of Development at Thoughtbot London • Andra Georgescu, Senior Developer at Capital One • Chris Evans, CTO at Netwealth • Doug Aitken and James Nylen, maintainers of @remoteintech • Jenny Brennan, maintainer of London Tech Meetups • Ruby for Good • Codebar • Thoughtbot office hours • Code First Girls
  16. Happy to help! @a_adewusi

  17. Appendix

  18. Creating and contributing to OS repos • GitHub's open source

    guide • Mozilla science lab • OpenDemographics (Recommended diversity survey questions for communities) • Atom’s contributing.md with code of conduct, introduction to the application, contribution instructions, style guides and issue/PR labelling. • Open government’s contributing.md with lovely, warm and welcoming opening statements.
  19. Repos renowned for welcoming first-timers • GitHub showcase • First

    Timers Only • CodeTriage • 24 Pull Requests (begins 1 Dec 2019) • Up For Grabs • Issuehub • First Contributions • First timers only Twitter bot • Your first PR Twitter bot • Awesome First PR Opportunities • First timers only issues on GitHub search
  20. Support for code newbies interested in open source • Ruby

    together • Outreachy • Google summer of code (for university students) • Rails Girls Summer of Code (taking a break in 2019, but still listing projects seeking contributors here)
  21. Survey data • FLOSS 2013: A Survey Dataset about Free

    Software Contributors: Challenges for Curating, Sharing, and Combining (2013) • Stack Overflow’s annual Developer Survey (2019) • Mozilla community survey (2014) • GitHub Open Source Survey (2017) • GitHub Octoverse (2018)
  22. It’s not easy to contribute and maintain open source •

    Nolan Lawson (2017) - What it feels like to be an open source maintainer • Nadia Eghbal (2016) - Roads and Bridges: The Unseen Labor Behind Our Digital Infrastructure • Mikeal Rogers (2017) - Time to Leave • Michael Bromley (2016) - Why I haven’t fixed your issue yet • Jan Lehnardt (2017) - Sustainable Open Source: The Maintainers Perspective or: How I Learned to Stop Caring and Love Open Source