Skip to content

Latest commit

 

History

History
154 lines (111 loc) · 4.95 KB

CONTRIBUTING.md

File metadata and controls

154 lines (111 loc) · 4.95 KB
Raw

Steps to follow 📜

Tip: Complete this process in GitHub (in your browser)

flowchart LR
    Fork[Fork the project]-->branch[Create a New Branch]
    branch-->Edit[Edit file]
    Edit-->commit[Commit the changes]
    commit -->|Finally|creatpr((Create a Pull Request))
Loading

0. Star The Repo 🌟

Star the repo by pressing the topmost-right button to start your wonderful journey.

1. Fork it 🍴

You can get your own fork/copy of GDSC-IPSA by using the Fork button.

2. Clone it 👥

NOTE: commands are to be executed on Linux, Mac, and Windows(using Powershell)

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

$ git clone https://github.com/{Your_Username}/gdsc-ipsa-web.git

This makes a local copy of the repository in your machine. Once you have cloned the gdsc-android-ipsa repository in Github, move to that folder first using the change directory command on Linux, Mac, and Windows(PowerShell to be used).

# This will change the directory to a folder
$ cd gdsc-android-ipsa

Move to this folder for all other commands.

3. Set it up ⬆️

Run the following commands to see that your local copy has a reference to your forked remote repository in Github :octocat:

$ git remote -v
origin  https://github.com/Your_Username/gdsc-ipsa-web.git (fetch)
origin  https://github.com/Your_Username/gdsc-ipsa-web.git (push)

Now, let's add a reference to the original GDSC-IPSA repository using

$ git remote add upstream https://github.com/GDSC-IPS-Academy/gdsc-ipsa-web

This adds a new remote named upstream. See the changes using

$ git remote -v
origin    https://github.com/Your_Username/gdsc-ipsa-web.git (fetch)
origin    https://github.com/Your_Username/gdsc-ipsa-web.git(push)
upstream  https://github.com/Your_Username/gdsc-ipsa-web.git (fetch)
upstream  https://github.com/Your_Username/gdsc-ipsa-web.git (push)

In your case, you will see

$ git remote -V
origin    https://github.com/Your_Username/gdsc-ipsa-web.git(fetch)
origin    https://github.com/Your_Username/gdsc-ipsa-web.git (push)
upstream  https://github.com/Your_Username/gdsc-ipsa-web.git (fetch)
upstream  https://github.com/Your_Username/gdsc-ipsa-web.git(push)

4. Sync it ♻️

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

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

5. Ready Steady Go... 🐢 🐇

Once you have completed these steps, you are ready to start contributing by checking our Good First Issue Issues and creating pull requests.

How to add your playlist to the website?

Follow this steps do add your playlist to the website:

#Step-1 Go to index.html
#Step-2 Write your playlist name in the code
#Step-3 Embed your playlist.
#Step-4 Write a sweet message.
#Step-5 You are done go aheaed and make your pull request.

6. Create a new branch ‼️

Whenever you are going to contribute. Please create a separate branch using command and keep your main branch clean (i.e. synced with remote branch).

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

Create a separate branch for contribution and try to use the same name of the branch as of folder.

To switch to the desired branch

# To switch from one folder to another
$ git checkout branchname

To add the changes to the branch. Use

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

Type in a message relevant to the code reviewer using

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

Now, Push your awesome work to your remote repository using

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

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

Help Contributing Guides 👑

We love to have articles and codes in different languages and the betterment of existing ones. Please discuss it with us first by creating a new issue. :tada: :confetti_ball: :smiley: Happy Contributing 😃 🎊 🎉