A scratchpad for folks at [SIC#16] Contributing to Free and Open Source software, fork of https://github.com/jesstess/contrib-test
-
Visit https://github.com/melvinzhang/contrib-test and flick the Fork button to fork this GitHub project.
-
Create a local copy of your fork of the repository using the following command:
git clone https://github.com/<your username>/contrib-test cd contrib-test
-
Using your favorite text editor, add a new file to this project.
a) Make the name of the file your first name, then a hyphen, then a random number, for example
jessica-19678
. b) In this file, add in where you are from and an open source project you are interested in contributing to, for example:I'm from NUS SoC and interested in contributing to Django!
-
Commit this addition to your fork of the project using the following commands:
git add <name of file> git commit -m "Added my open source interests."
-
Push your changes to the remote repository with the following command:
git push
-
Visit the GitHub page for your fork of the project, e.g.
https://github.com/<your username>/contrib-test
Observe that your file is visible in the GitHub web view for the project.
-
Click the green button to create a pull request for your changes. This will take you to a page where you can review your diff and commit message. Click the green "Create Pull Request" button, leave a comment, and click the green "Send pull request button".
-
The owner of the project, melvinzhang, can now review and merge your pull request. Wait a few minutes for this to happen.
-
Update your fork of the project to see everyone else's changes, using the following command:
git pull https://github.com/melvinzhang/contrib-test/ git push
-
Explore the changes with commands like
git log
andgit show
.