Repository files navigation

You can get your own fork/copy ofOpenSoft-Jukebox by using theFork button in the top right corner.

You need to clone (download) it to local machine using

$ git clone https://github.com/Your_Username/OpenSoft-Jukebox.git

This makes a local copy of repository in your machine.

Once you have cloned theOpenSoft-Jukebox repository in Github, move to that folder first using change directory command on linux and Mac.

# This will change directory to a folder OpenSoft-Jukebox$cd OpenSoft-Jukebox

Move to this folder for all other commands.

Run the following commands to see thatyour local copy has a reference toyour forked remote repository in Github

$ git remote -vorigin  https://github.com/Your_Username/OpenSoft-Jukebox.git (fetch)origin  https://github.com/Your_Username/OpenSoft-Jukebox.git (push)

Now, lets add a reference to the originalOpenSoft-Jukebox repository using

$ git remote add upstream https://github.com/lbs-iitkgp/OpenSoft-Jukebox.git

This adds a new remote namedupstream.

See the changes using

$ git remote -vorigin    https://github.com/Your_Username/OpenSoft-Jukebox.git (fetch)origin    https://github.com/Your_Username/OpenSoft-Jukebox.git (push)upstream  https://github.com/lbs-iitkgp/OpenSoft-Jukebox.git (fetch)upstream  https://github.com/lbs-iitkgp/OpenSoft-Jukebox.git (push)

Always keep your local copy of repository updated with the original repository.Before making any changes and/or in an appropriate interval, run the following commandscarefully to update your local repository.

# Fetch all remote repositories and delete any deleted remote branches$ git fetch --all --prune# Switch to `master` branch$ git checkout master# Reset local `master` branch to match `upstream` repository's `master` branch$ git reset --hard upstream/master# Push changes to your forked `OpenSoft_Jukebox` repo$ git push origin master

Once you have completed these steps, you are ready to start contributing by adding your work or by checking the repo'sHelp Wanted Issues, and creatingpull requests.

Whenever you are going to make contribution. Please create seperate branch using command and keep yourmaster branch clean (i.e. synced with remote branch).

# It will create a new branch with name Branch_Name and switch to branch Folder_Name-Your_Username$ git checkout -b Folder_Name-Your_Username

Create a seperate branch for contibution and try to use same name of branch as of folder concatenated with an underscore and your username.

In each of these folders (ie. tasks), add your contribution by creating a new folder with your 'username' as the title, and add your work there.

Try to keep a separate branch for each of your tasks. (Reasons will be obvious when you start adding commits)

To switch to desired branch

# To switch from one folder to other$ git checkout Folder_Name-Your_Username

To add the changes to the branch. Use

# To add all files to branch Folder_Name-Your_Username$ git add.

Type in a message relevant for the code reveiwer using

# This message get associated with all files you have changed$ git commit -m'relevant message'

If you'd like to add a more detailed commit message, skip the-m and when you press enter, a text editor will open where you can add your commit message. Followthis tutorial for some guidance on writing good commit messages.

Now, Push your awesome work to your remote repository using

# To push your work to your remote repository$ git push -u origin Folder_Name-Your_Username

Finally, go to your repository in browser and click oncompare and pull requests.Then add a title and description to your pull request that explains your precious effort.

Feel free to ping us anytime!

Naresh

Athitya Kumar

Cheers!! 😄