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

It takes a digital village

It takes a digital village

An analytical-ish look at what grows strong communities on GitHub.com

Ben Balter

May 11, 2017
Tweet

More Decks by Ben Balter

Other Decks in Technology

Transcript

  1. It takes a digital village An analytical-ish look at what

    grows strong communities on GitHub.com @benbalter ben.balter.com [email protected]
  2. GET /repositories/:repo_id/community/profile [ { "health_percentage": 100, "files": { "code_of_conduct": {

    "name": "Contributor Covenant", "key": "contributor_covenant", "url": null, "html_url": "https://github.com/octocat/Hello-World/blob/master/CODE_OF_CONDUCT.md" }, "contributing": { "url": "https://api.github.com/repos/octocat/Hello-World/contents/CONTRIBUTING", "html_url": "https://github.com/octocat/Hello-World/blob/master/CONTRIBUTING" }, "license": { "name": "MIT License", "key": "mit", "url": "https://api.github.com/licenses/mit", "html_url": "https://github.com/octocat/Hello-World/blob/master/LICENSE" }, "readme": { "url": "https://api.github.com/repos/octocat/Hello-World/contents/README.md", "html_url": "https://github.com/octocat/Hello-World/blob/master/README.md" } }, "updated_at": "2017-02-28T19:09:29Z" } ]
  3. Types of projects on GitHub 80% - Homework, published code,

    terrible ideas 20% - Open source projects
  4. Websites attract PRs # of Pull Requests % of repos

    with homepage 1-10 23% 11-100 44% 101-1000 65% 1000+ 84%
  5. Friction (n) - the time it takes to go from

    "I want to contribute" to "I have"
  6. Foster a welcoming community Artifacts • README • Contributing •

    License • Code of conduct Practices • Welcoming • Coaching • Thanking • Mentoring
  7. CONTRIBUTING files attract contributions Pull requests Unique contributors Repeat contributors

    1-10 2% 1% 1% 11-100 8% 16% 22% 101-1000 25% 42% 34% 1000+ 58% 6%* 1%* Percentage of repositories with a CONTRIBUTING file
  8. Things to include in your README • What problems are

    we solving? • What's the technology stack? • What's the project's status? • How to use/contribute? • If you want contributions http://ben.balter.com/2017/04/14/your-projects-readme-is-your-project-constitution/
  9. Percentage of repositories with a README Pull requests Unique contributors

    Repeat contributors 1-10 86% 69% 73% 11-100 92% 86% 84% 101-1000 97% 85% 81%* 1000+ 98% 99.75% 99.84%
  10. Percentage of repositories with a LICENSE Pull requests Unique contributors

    Repeat contributors 1-10 28% 18% 24% 11-100 50% 64% 66% 101-1000 67% 75% 78% 1000+ 82% 97% 97%
  11. Why add a code of conduct? • Reasonable people disagree

    on the internet • Establishes expectations for community norms • Signals that your project is a welcoming community • Better to have before something happens, not after • It's the right thing to do
  12. Percentage of repositories with a Code of Conduct Pull requests

    Unique contributors Repeat contributors 1-10 0% 0% 0% 11-100 1% 1% 1% 101-1000 2% 3% 3% 1000+ 8% 0%* 0%*
  13. Repeat contributors are hard to find # of single contributors

    Code of Conduct CONTRIBUTING LICENSE README Homepage 1-10 0% 1% 16% 68% 11% 11-100 1% 19% 66% 86% 28% 101-1000 5% 51% 78% 92% 20% 1000+ 1% 3% 97% 99% 17%
  14. Large projects are organization owned # of pull requests %

    of org-owned repositories 1-10 19% 11-100 50% 101-1000 75% 1000+ 94%
  15. Adoption is low % of repositories >= 1 issue >=

    1 PR >= 5 PRs >= 100 PRs >= 500 PRs Code of Conduct 0% 0% 1% 2% 5% CONTRIBUTING 0% 3% 7% 27% 50% LICENSE file 4% 31% 47% 68% 80% README file 10% 87% 90% 96% 98%
  16. Expanded community metrics • Issue and PR templates • Issues

    opened by non-collaborator • Contributions from non-collaborators
  17. It takes a digital village An analytical-ish look at what

    grows strong communities on GitHub.com @benbalter ben.balter.com [email protected]