This is a starter repository made specifically so we can help you get your first pull request and learn the basics of Git and GitHub.
If you're a beginner and you've come looking for your first contribution, we are here to help.
We've provided the instructions for you to get started with contributing to Open Source. Scroll down for more info.
Firstly, install Git onto your local system. If you are on linux or mac, you get Git pre-installed.
However, if you are on Windows you will have to install it. To do so, click here.
Head over to GitHub.com and create an account by signing up.
Open sourcing and contributing to the free internet is what drives the internet today, and everyone and every single contribution is appreciated in the Open Source world.
And, you can join us with your first pull request right here!
You can star and fork this repository on GitHub at the top of the repository.
Forking allows you to create a version of the repository for yourself.
This allows you to make changes to the repository without requiring any permissions or interfering with the existing repository.
Now, redirect yourself to your fork of the repository, which should have a URL like so,
To make your own copy of the repository that you would want to contribute to, you'll need to clone it to your system for easier access.
Using the git clone commmand, you could clone the repository to your local system.
While the URL would essentially be like,
It's easier to just click on the clone icon and copy it to your clipboard.
After which, just direct yourself to whichever place you wish to clone the repository to using the change directory or cd command in terminal and then git clone your project.
Direct yourself into the repository using cd Hackoctoberfest-2020.
Now, we'll create and switch onto the branch that we will be working on, for editing file in the project.
Creating a branch,
git branch branch-name
Switching from master branch to another branch,
git checkout branch-name
Viewing all the available branches for your repository,
git branch -a
To help make contribution easy, we have made a fixed template for you to work on. Follow the steps provided below.
We can finally get to contributing to the repository now!
Now that you've switched over to another branch, change your directory to contributors using cd contributors.
Create a file with your github username with a .json extension.
Example : GITHUB-USERNAME.json , where GITHUB-USERNAME is your current GitHub username.
The contents of the JSON file in the below format,
{
"github-username": "YOUR-GITHUB-USERNAME",
"favourite-game": "YOUR-FAVOURITE-GAME",
"favourite-language": "YOUR-FAVOURITE-PROGRAMMING-LANGUAGE",
"favourite-color": "#FFFFFF"
}"github-username" should be the same one as the one you're making the pull request from.
"favourite-game" can be any game that you really like.
"favourite-language" has to be your favourite programming language or any programming language that you really want to learn.
"favourite-color" can be any color in hex format (example: #FFF44F). You can pick any color from Google's color picker.
If you want to add something more, maybe a project, or a program, or just a photograph you took, Maybe even showcase your website.
You can. You can even add resources or YouTube links to videos you found useful for programming.
Just create a .json file with your GitHub user name inside the "content-sharing" folder and add links to anything you want to share. example :
{
"Resources" : ["https://www.youtube.com/user/thenewboston","https://docs.github.com/"],
"Projects" : ["https://github.com/torvalds/linux"],
"Images" : ["https://tinyurl.com/y45lx6oc"],
"Websites" : ["https://www.google.com/"]
}Note : Make sure your contributions are in line with our Code of Conduct.
You can add all the files that you've updated using the command git add -A
Then, you commit to save the files, like how you would at a checkpoint, git commit -m "added myself"
Now, you want to push to your fork online, that works with git push origin branch-name.
It is important to keep your local repository updated with the project in order to avoid merge conflicts. To do this, you'll have to configure a remote for the fork and then sync the fork.
In order to create a remote for the fork, you'll need to specify a new remote upstream repoistory (the repository you forked from) to sync with the fork. You'll be using the git remote add command to do that.
git remote add upstream https://github.com/Open-Source-Community-VIT-AP/OpenSource101.git
Note: We have referenced the original repository as "upstream".
Once the remote references to the original repository you forked from, you are ready to sync changes in order to keep your local copy up to date. To do this, we use the git fetch command.
git fetch upstream
Once done, you need to switch back to the master branch, you can do this using
git checkout master
Now, merge changes made from the original repository's master branch with your current local master branch using
git merge upstream/master
Once your local repository is updated, you are all set to send us a pull request.
To do that, just open your forked repository and click on pull request, now you can see a green button that says "New pull request".
Create the pull request and lay back and relax until you receive a notice signifying the acceptance of your pull request or, the request to modify your changes.
Note : If you have any question regarding any of the steps above or about anything related to this repository, just create an issue.
Now, that you've made your first pull request, it's time to explore the vast Open Source network, filled with projects that have ground-breaking potential.
Projects that can revolutionalize the way we look at things.
As well as create your own for other people to appreciate and contribute to!
