june 2014 pdx pug: ways to plug into the puppet community
DESCRIPTION
June 2014 PDX PUG: Ways to Plug Into the Puppet Community by Eric Sorenson, Puppet LabsTRANSCRIPT
![Page 1: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/1.jpg)
This page is intentionally left blank
![Page 2: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/2.jpg)
ContributingThe dos and don’ts of
![Page 3: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/3.jpg)
con·tri·bu·tion noun: contribution plural noun: contributions !!1. the part played by a person or thing in bringing about
a result or helping something to advance.
2. an article or other piece of writing submitted for publication in a collection.
!
!
from late Latin contributio(n-), from Latin contribuere ‘bring together, add’
![Page 4: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/4.jpg)
But notice that this is not very prescriptive: !
nothing about having to write code, or what degree you have, or where
you’re from, or what you look like
![Page 5: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/5.jpg)
If you can move things forward, we’d love for you to get involved!
![Page 6: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/6.jpg)
users
authors
devs
![Page 7: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/7.jpg)
Bug reports Documentation fixes Testing Mailing list/Ask help Community building Comment on proposals Code!
![Page 8: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/8.jpg)
On bugs
![Page 9: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/9.jpg)
Search for duplicates File a good bug Metadata Updating your bug
![Page 10: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/10.jpg)
This works for both old and new bugs! !
adding info to existing tickets helps a ton!
![Page 11: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/11.jpg)
![Page 12: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/12.jpg)
Feature requests help too, especially with use cases. !
focus on the problem
![Page 13: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/13.jpg)
On documentation
![Page 14: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/14.jpg)
Docs are hugely important; thousands of people look at them every day! !
how many of you have used Google as a debugger?
![Page 17: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/17.jpg)
Perfection is not required; content is king! !
don’t need perfect grammar or speling; focus on building new and updated content
![Page 18: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/18.jpg)
On testing
![Page 19: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/19.jpg)
Software is only as good as the people that test it
![Page 20: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/20.jpg)
Test new builds, release candidates, experimental features !
and try out fixes for bugs you’re following!
![Page 21: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/21.jpg)
On performance
![Page 22: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/22.jpg)
How many people think puppet is as fast as it can be?
![Page 23: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/23.jpg)
Profile our stuff! Send us results! Tell us what’s slow, and when we regress!
![Page 24: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/24.jpg)
Need more input!
![Page 25: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/25.jpg)
On community
![Page 26: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/26.jpg)
![Page 27: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/27.jpg)
On code
![Page 28: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/28.jpg)
"This is the Puppet community. There are many like it, but this one is ours."
![Page 29: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/29.jpg)
Core platform
FactsProviders Modules Layered tools
![Page 30: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/30.jpg)
Patches
![Page 31: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/31.jpg)
The CLA
![Page 32: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/32.jpg)
What happens after you file a pull request?
![Page 33: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/33.jpg)
![Page 34: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/34.jpg)
![Page 35: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/35.jpg)
PR triage
Announce on mailing list Start hangout Pick a PR
Discuss Merge!
Close
Submitter follow-up
Committer follow-up
Needs more discussion
![Page 36: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/36.jpg)
http://resresres.deviantart.com/art/Take-a-number-267706889
![Page 37: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/37.jpg)
Show up to the triage, Respond to comments, Be your own advocate
![Page 38: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/38.jpg)
There are many reasons why a pull request may not get merged
![Page 39: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/39.jpg)
Basic form, Quality, Correctness, Verification, Consensus
![Page 40: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/40.jpg)
However!
![Page 41: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/41.jpg)
![Page 42: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/42.jpg)
Incorrect code helps! Incomplete code helps! !
you are not your code, and discussing ideas as a group can be
highly valuable
![Page 43: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/43.jpg)
Anti-patterns
![Page 44: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/44.jpg)
![Page 45: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/45.jpg)
Being impatient won’t get your bugs fixed more quickly.
![Page 46: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/46.jpg)
Being hostile or overly confrontational does not help.
![Page 47: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/47.jpg)
Wanting to be right at all costs is "scorched earth" collaboration.
![Page 48: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/48.jpg)
Claiming to represent all puppet users is wishful thinking.
![Page 49: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/49.jpg)
Expecting other community members to do work for you is unlikely to work.
![Page 50: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/50.jpg)
Food for thought
![Page 51: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/51.jpg)
We’re looking for more maintainers!
![Page 52: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/52.jpg)
How can we improve ticket triage?
![Page 53: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/53.jpg)
How can we get better diagnostic information from users when they encounter bugs?
![Page 54: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/54.jpg)
How can we help new contributors find things to work on?
![Page 55: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/55.jpg)
We’re all in this together, people!
![Page 56: June 2014 PDX PUG: Ways to Plug Into the Puppet Community](https://reader033.vdocuments.net/reader033/viewer/2022060108/554f3defb4c90572088b5109/html5/thumbnails/56.jpg)
deepak giridharagopal
eric sorenson
original talk by