In this project, you'll learn how to contribute to an open source project and then you'll make your first pull request. This workflow will be used to collaborate with other students during the program.
The first part of this project will show you how to make an open source contribution and the second part will have you add your solution to one of the questions from the "Test Yourself" lesson to the repo.
Let's say you want to contribute to a website and the code is on Github. How do you do that?
The easiest way to contribute is actually to do what you've already done during the Git Assignment -- making a simple change directly on the Github website. See the video below for details:
...This is fine for small changes, but doesn't cut it for anything larger. Use the workflow below.
If you want to do more than just modify a single file, you'll need to actually get the target repo onto your computer and eventually send your changes back via a pull request.
To learn this flow, we'll first show you the procedure as it's used for a real open source project. This project uses multiple branches, so it's a bit more complicated that what you'll be doing here but it's a good illustration of the concepts:
You're going to make a contribution to the prep_basics repo. It will require you to replicate many of the things you just saw, though not all of them. For starters, we're only using the
master branch so there's no need to worry about making a feature branch unless you want the practice -- whether you do or don't won't make a difference to the final pull request.
test-yourself-answers.md. It contains the questions from the "Test Yourself" lesson and space to put answers.
Similar to the video above, you'll need to:
...So go do it!
We'll look at your pull request to verify that it's proper before accepting it. If there are changes you need to make (for instance removing additional files that got sucked into it by accident), we'll let you know as part of the Pull Request dialogue. You're ready to move onto the Design mini-course, congratulations!