How Can I Contribute?
A Guide to Making Your First Open Source Contribution
By The End You'll Know...
- Why you should contribute
- Skillz you can contribute
- How to find a project
- Lightening fast introduction to Git and Github
$ whoami
Lucy Wyman
Software Engineer - Bolt
What is Open Source?
- Code is publicly available
- Can be contributed to by the public
- Actively maintained and open to contribution
- Free software?
Sounds great, but...
- Contributing to open source doesn’t benefit me at all
- I’m not a good enough programmer to contribute to open source
- I don’t know the project well enough to contribute
- I don’t write code, so I have nothing to contribute
- I’m just a student / community member / manager / llama, I don’t have anything to contribute
- Contributing to open source is hard
Why Should You Contribute?
- Give back to a project you use + love
- Encourage collaboration and innovation
- Improve a skill
- Don't reinvent the wheel
- Make the world a better place!
How Can You Contribute?
File Bugs
File Bugs
Github issues | Bug tracker | Contact (email, twitter, etc.)
Include:
- What version you were using, browser version, OS, etc.
- What you were trying to do
- How you tried to do it (be detailed!)
- Steps for reproduction
- What you expected to happen
- What actually happened
Write Documentation
- Contribute to official documentation
- Add or update a README
- Write a blog post
- Getting started guide
Answer Questions
- In Github issues
- On IRC or Slack
- On StackOverflow
- On Reddit
Educate
- Give a talk!
- This can be at a user group meeting, bar camp, or other event
- Volunteer for a workshop or event
- Represent an open source project at an event
Design
- A logo
- A helpful diagram
- A new feature
Finding a Project
In order of perceived helpfulness:
Getting Started Contributing
Making your first PR
https://slides.lucywyman.me/how-can-i-contribute.html#15 https://github.com/pop/i-love-tacos
First Steps
- Make an account on Github
- Read the README and/or CONTRIBUTING docs.
- If these don't exist, make an issue and add them!
Installing a Client
- Official Git Docs (cover all platforms)
- On Windows
- On OSX
- On Linux
Fork a Repo
Creating your own copy
Clone a Repo
Downloading from Github
git clone ssh@github.com:lucywyman/i-love-tacos.git
Make Changes
echo 'I love tacos' > tacos.txt
Stage and Commit
git status
git add truth.txt
git commit
git status
Push
git push
Make a Pull Request
Git Resources and Tutorials
- try.github.io for an easy, hands-on tutorial
- TutorialsPoint Git Tutorial for a better understanding of what git can do
- Vogella Git Tutorial for a really deep dive into git
- Codecademy Git Tutorial for a more lesson-based approach
Resources
Questions?
