Don't Go It Alone: Recruiting Contributors

Slide 1

Slide 1 text

Don’t Go It Alone: Recruiting Contributors VP Community, Sensu Inc. Matt Broberg @mbbroberg Open Source 101

Slide 2

Slide 2 text

A Favor Please & Thank You @mbbroberg

Slide 3

Slide 3 text

@mbbroberg

Slide 4

Slide 4 text

Patterns @mbbroberg

Slide 5

Slide 5 text

@mbbroberg https://www.designhacks.co/products/cognitive-bias-codex-poster

Slide 6

Slide 6 text

Ask* @mbbroberg

Slide 7

Slide 7 text

@mbbroberg Responsible for the awareness, engagement and health of the Sensu Community. Matt Broberg VP Community, Sensu Inc 200+ Plugins On GitHub 10+ Maintainers Volunteering to make monitoring better Open Framework To connect all your monitoring pieces

Slide 8

Slide 8 text

@mbbroberg https://twitter.com/sarahnovotny/status/280822396477378560

Slide 9

Slide 9 text

@mbbroberg https://twitter.com/eryno/status/802600628413460480

Slide 10

Slide 10 text

Open Source? @mbbroberg

Slide 11

Slide 11 text

@mbbroberg

Slide 12

Slide 12 text

Ask @mbbroberg

Slide 13

Slide 13 text

@mbbroberg

Slide 14

Slide 14 text

You @mbbroberg

Slide 15

Slide 15 text

Asking for Help On GitHub ● License ● README.md ● CONTRIBUTING.md ● Pull Request Reviews ● Issues ● Labels ● Releases ● Milestones ● CHANGELOG.md ● Templates (.github/) ● Permissions (Teams & .owners) ● Saved Replies Beyond GitHub ● Acronyms (LGTM) ● Continuous Integration (Travis) ● Chat (Slack/IRC/Gitter) ● Recognition (All Contributors) ● Social Media (Twitter, etc) ● Sharing (Blog, Podcast, Talk) Psychological ● Just ask (Ben Franklin Effect) ● Make it easy (Sunk cost) ● Tell a good story (survivor bias)

Slide 16

Slide 16 text

!(All or Nothing) @mbbroberg

Slide 17

Slide 17 text

Basics @mbbroberg

Slide 18

Slide 18 text

Asking for Help Beyond GitHub ● Acronyms (LGTM) ● Continuous Integration (Travis) ● Chat (Slack/IRC/Gitter) ● Recognition (All Contributors) ● Social Media (Twitter, etc) ● Sharing (Blog, Podcast, Talk) Psychological ● Just ask (Ben Franklin Effect) ● Make it easy (Sunk cost) ● Tell a good story (survivor bias) Basics On GitHub ● License ● README.md ● CONTRIBUTING.md ● Pull Request Reviews ● Issues ● Labels ● Releases ● Milestones ● CHANGELOG.md ● Templates (.github/) ● Permissions (Teams & .owners) ● Saved Replies

Slide 19

Slide 19 text

Disclaimer: I am not a lawyer! License Basics Choose how open you are for contribution (and ownership). Permissive MIT Protective Apache 2.0 @mbbroberg

Slide 20

Slide 20 text

https://opensource.guide/legal/

Slide 21

Slide 21 text

README.md Basics WHAT, WHY and HOW Good Default: ## Overview ## Installation ## Getting Started ## How to Help (Advanced) ## Contributors (Advanced) @mbbroberg

Slide 22

Slide 22 text

Advanced @mbbroberg https://github.com/sensu-plugins/co mmunity#how-you-can-help

Slide 23

Slide 23 text

Advanced https://github.com/kentcdodds/ all-contributors

Slide 24

Slide 24 text

Pull Request Reviews Basics Do you accept PRs? Good default: ● Be responsive ● Have tests (advanced) @mbbroberg

Slide 25

Slide 25 text

Basics @mbbroberg https://bluedynamics.com/blog/joha nnes/watch-all-your-repos

Slide 26

Slide 26 text

Basics @mbbroberg guides.github.com/introduction/flow/

Slide 27

Slide 27 text

Advanced @mbbroberg

Slide 28

Slide 28 text

Issues Basics What do you hope to accomplish but haven’t yet? Good default: ● Any missing documentation ● Features you want to implement ● Ask for a Maintainer (Advanced) @mbbroberg

Slide 29

Slide 29 text

Basics @mbbroberg https://github.com/sensu-plugins/sensu-plugins-s endgrid/issues/1

Slide 30

Slide 30 text

Advanced @mbbroberg https://github.com/sensu-plugins/sensu-plugins/c ommunity/issues/80

Slide 31

Slide 31 text

Psychology Basics How are you helping people help you? Good default: ● Accept contribution liberally ● Encourage repeat contribution (advanced) @mbbroberg

Slide 32

Slide 32 text

Basics @mbbroberg

Slide 33

Slide 33 text

Advanced @mbbroberg https://github.com/blog/2135-saved-replies

Slide 34

Slide 34 text

Comment: “Thank you for contributing @user! I made a couple comments in the review, do you have time to add them?” If they don’t get back to you ~3 days: “Hey again @user, no worries on these little things - I’ll merge this and add to it. Thanks again!” Then go to an open issue: “Hey @user, I wonder if you could help out by working on this issue. Wdyt?” Situation: Pull Request is missing something you’d like to see before merging. Advanced @mbbroberg

Slide 35

Slide 35 text

Growth @mbbroberg

Slide 36

Slide 36 text

Beyond GitHub ● Acronyms (LGTM) ● Continuous Integration (Travis) ● Chat (Slack/IRC/Gitter) ● Recognition (All Contributors) ● Social Media (Twitter, etc) ● Sharing (Blog, Podcast, Talk) Psychological ● Just ask (Ben Franklin Effect) ● Make it easy (Sunk cost) ● Tell a good story (survivor bias) On GitHub ● License ● README.md ● CONTRIBUTING.md ● Pull Request Reviews ● Issues ● Labels ● Releases ● Milestones ● Templates (.github/) ● Permissions (Teams & .owners) ● Saved Replies Asking for Help Growth Focus

Slide 37

Slide 37 text

No content

Slide 38

Slide 38 text

Don’t Trust Me @mbbroberg

Slide 39

Slide 39 text

@mbbroberg https://twitter.com/mbbroberg/status/961348173628284928

Slide 40

Slide 40 text

@mbbroberg

Slide 41

Slide 41 text

@mbbroberg

Slide 42

Slide 42 text

@mbbroberg

Slide 43

Slide 43 text

@mbbroberg https://twitter.com/mbbroberg/status/961348173628284928

Slide 44

Slide 44 text

@mbbroberg

Slide 45

Slide 45 text

Bigger Q @mbbroberg

Slide 46

Slide 46 text

Open Source? @mbbroberg

Slide 47

Slide 47 text

Decision Tree (Simplified) Should I share? Yes @mbbroberg

Slide 48

Slide 48 text

Decision Tree (Simplified) Should I share? Yes @mbbroberg

Slide 49

Slide 49 text

Decision Tree (Expanded) Could I share? Yes Do I have to? No @mbbroberg

Slide 50

Slide 50 text

Don’t Panic It’s a big world out there. @mbbroberg

Slide 51

Slide 51 text

0.03% octoverse.github.com @mbbroberg

Slide 52

Slide 52 text

0/42 @mbbroberg

Slide 53

Slide 53 text

Survivorship Bias (via XKCD) @mbbroberg

Slide 54

Slide 54 text

Your Reason Avoid other people’s @mbbroberg

Slide 55

Slide 55 text

No content

Slide 56

Slide 56 text

Slide 57

Slide 57 text

Start Simple The basics are enough 99% of the time. @mbbroberg

Slide 58

Slide 58 text

Ask @mbbroberg Don’t go it alone

Slide 59

Slide 59 text

Learn Brains @mbbroberg They’re more important than algorithms

Slide 60

Slide 60 text

Have Fun @mbbroberg If you’re not, rm -rf * and go for a walk

Slide 61

Slide 61 text

Stay Healthy @mbbroberg It’s a marathon, don’t burnout for a sprint

Slide 62

Slide 62 text

Show of Hands Please & Thank You @mbbroberg

Slide 63

Slide 63 text

Thanks! VP Community, Sensu Inc. Matt Broberg @mbbroberg Open Source 101 Maintainer Bits ● Learn GitHub (bitly.com/git-it) ● Readmes (awesome-readme) ● Advice for maintainers (thread) ● GitHub Maintainers program ● All Contributors project ● Sane GitHub Labels project Psychological Bits ● Ben Franklin Effect ● Buy the cognitive bias codex

Slide 64

Slide 64 text

TL;DR

Slide 65

Slide 65 text

“In order to act, we need to be confident in our ability to make an impact and to feel like what we do is important.”