Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Your first PR: contributing to open-source software
Search
Gareth Ellis
May 19, 2016
Technology
0
130
Your first PR: contributing to open-source software
Lightning talk given to NomadPHP EU May 2016.
Gareth Ellis
May 19, 2016
Tweet
Share
More Decks by Gareth Ellis
See All by Gareth Ellis
Introduction to SOLID - PHP UK 2017
garethellis36
0
120
Introduction to SOLID - PHPOxford
garethellis36
0
140
Write more expressive tests with Hamcrest
garethellis36
0
30
Write more expressive tests with Hamcrest PHP
garethellis36
0
94
Other Decks in Technology
See All in Technology
単回帰分析について数式を追いながら実装してみた
kentaitakura
0
500
#51 “Empowering Azure Storage with RDMA”
cafenero_777
3
210
Cloud Friendly(?) Jenkins. How we failed to make Jenkins cloud native and what we learned?
onenashev
PRO
0
110
HoneycombとOpenTelemetryでオブザーバビリティに入門してみる
sumiren
2
150
任意コード実行の原理
ffri
0
170
.NETの非同期戦略とUnityとの相互運用
neuecc
2
2.4k
バッチ処理のSLOをどう設計するか
rynsuke
7
550
10分でわかるfreeeのQA
freee
0
230
AMLD 2024 - Build Your Own GPT
donlelef
1
260
KTC_DBRE.pdf
_awache
0
290
OpenTelemetry実践 はじめの一歩
taxin
0
310
Introduction to Jetpack Compose
pohjus
1
110
Featured
See All Featured
We Have a Design System, Now What?
morganepeng
42
6.7k
Statistics for Hackers
jakevdp
789
220k
What the flash - Photography Introduction
edds
64
11k
実際に使うSQLの書き方 徹底解説 / pgcon21j-tutorial
soudai
111
35k
Robots, Beer and Maslow
schacon
PRO
154
7.9k
jQuery: Nuts, Bolts and Bling
dougneiner
57
7.1k
Agile that works and the tools we love
rasmusluckow
323
20k
Fight the Zombie Pattern Library - RWD Summit 2016
marcelosomers
226
16k
5 minutes of I Can Smell Your CMS
philhawksworth
199
19k
Imperfection Machines: The Place of Print at Facebook
scottboms
257
12k
Creatively Recalculating Your Daily Design Routine
revolveconf
209
11k
Practical Orchestrator
shlominoach
180
9.7k
Transcript
Your first PR: contribu0ng to open-‐source projects Gareth Ellis
(@garethellis) Developer, Language Services, ICON plc For NomadPHP, May 2016
Who am I? • Developer, Language Services group,
ICON plc • Professional developer since 2013 • Co-‐founder/organizer PHPOxford • Occasional contributor to open-‐ source projects
Why should I contribute?
Give something back It’s the circle of life open-‐source
soZware
Self-‐improvement Exposure yourself to new codebases, techniques and pa]erns.
Fun! “It’s good for the soul” Nils Luxton
(@nilsluxton)
What can I contribute?
Iden0fy a project What do you use regularly that
could benefit from some improvements?
Types of contribu0on Submit an issue on Github
Answer a ques0on on StackOverflow Documenta0on Blog post Code!
Contribu0ng to source code Changes can be big or
small
Contribu0ng to source code The project may have already
iden0fied a gap – can you help?
How do I contribute?
Before you begin! Consider discussing what you want to
change with the project maintainers.
CONTRIBUTING.md Read the contribu0ng guidelines.
The process! 1. Fork 2. Clone 3.
Branch 4. Change 5. Commit 6. Push 7. Submit Pull Request 8. Review
Fork
Clone $ git clone
[email protected]
:garethellis36/cakephp.git $ cd cakephp
$ composer install
Clone (2) $ git remote add upstream
[email protected]
:cakephp/cakephp.git
Branch $ git checkout –b my-‐awesome-‐new-‐feature
Make your changes Follow contribu0on guidelines Write tests
as necessary
Commit and push $ git add src/Folder/AnotherFolder/ChangedFile.php $
git commit –m “Here’s a descrip0on of this awesome new feature” $ git push –u origin my-‐awesome-‐new-‐feature
Submit the Pull Request! Screenshot used with permission of
Rob Allen
Submit the Pull Request! (2) Screenshot used with permission
of Rob Allen
Review Discuss your PR with the project maintainers
Make changes if necessary To add changes to your PR, simply change, commit & push
Further reading: Find projects to contribute to:
h]ps://yourfirstpr.github.io/ h]p://issuehub.io/ h]p://up-‐for-‐grabs.net/ Joind.in: h]ps://joind.in/about h]ps://akrabat.com/the-‐beginners-‐guide-‐to-‐contribu0ng-‐to-‐a-‐github-‐project/ (Rob Allen) h]p://www.lornajane.net/posts/2015/code-‐reviews-‐before-‐you-‐even-‐run-‐the-‐code (Lorna Mitchell)
Thanks for listening. h]ps://joind.in/talk/c5551
[email protected]
@garethellis h]ps://blog.garr.co.uk