Make Your First Contribution on GitHub

This talk was presented at the Open Source Bridge conference on June 21st, 2016.

Interested in becoming a contributor to open source projects? In this talk, I'm going to show you the technical aspects involved in working with git and GitHub to prepare and submit contributions, and then working with project maintainers to get them merged.

Transcript

1. Make Your First Contribution on ____________ Miguel Grinberg @miguelgrinberg
2. About me
3. About me
4. About me http://blog.miguelgrinberg.com
5. About me
6. Do you have what it takes?
7. YES! YES!
8. Where do you start?
9. Learn by lurking
10. Learn by doing
11. Be a good guest
12. Getting ready
13. Create a free GitHub account
14. Install git
15. Learn the unix command line
16. The 10,000 foot view
17. gremlin16/mortgage a.k.a “upstream” you/mortgage a.k.a. “origin” ~/mortgage $ _ Pull Push Merge The GitHub flow Pull Request
18. git branching master feature-1 feature-2 feature-3
19. Let’s get our hands dirty!
20. Getting the code gremlin16/mortgage you/mortgage FORK git clone ~/mortgage $ _ git clone https://github.com/ username/repo git config user.email your-email-address git remote add upstream https://github.com/ username/repo
21. Making changes in a branch ~/mortgage my-feature-branch $ _ ~/mortgage my-feature-branch $ _ ~/mortgage master $ _ git checkout -b do some work git checkout -b feature-branch-name
22. Saving your branch you/mortgage my-feature-branch ~/mortgage my-feature-branch $ _ ~/mortgage my-feature-branch $ _ git add/commit git push git add file(s) git commit -m " commit-message " git push origin feature-branch-name
23. Submitting the contribution you/mortgage my-feature-branch gremlin16/mortgage pull request PULL REQUEST merge gremlin16/mortgage master
24. Syncing with upstream ~/mortgage master $ _ ~/mortgage master (stale) $ _ ~/mortgage my-feature-branch $ _ git checkout git pull git checkout master git pull upstream master
25. Cleaning up local branches ~/mortgage master $ _ ~/mortgage master $ _ git branch -D git branch -D feature-branch-name
26. Submitting a contribution v2 you/mortgage my-feature-branch gremlin16/mortgage pull request PULL REQUEST merge ~/mortgage my-feature-branch $ _ gremlin16/mortgage master review (s) git push $ _ ~/mortgage my-feature-branch git commit
27. Thank You! Questions? @miguelgrinberg miguel.grinberg@gmail.com