Giter Club home page Giter Club logo

hello-opensource's Introduction

Hello Opensource

This is your "Hello world" for open source contributions. Want to try practising some PRs? This is the right place!

Step 1: Fork this repo

fork this repository

This creates a copy of this repo to your GitHub account. Consider a scenario where you want to work with some code from your friend. So you copy the code in a flash drive from your friends PC. Forking is similar to this.

Step 2: Clone the repo

Now, go to the fork of this repo on your account. To work with code, clone that repo to your local machine (as shown below). Similar to copying the code from the flash drive to your system. If you haven't installed the git, then this is the best time to do this - here is a guide on installing git

Click on "Code"

Copy the link

To clone the repo, open the terminal and run the command

git clone "url-you-copied"

Now you have the project repo on your local machine.

Step 3: Create a new branch

Go to the repo directory on your machine

cd Hello-opensource

Create a new branch (It is a good practice to create a new branch if you wish to contribute)

git checkout -b <branch-name>

for example:

git checkout -b add-bruce-wayne

Why create a new branch? You don't want to mess the code your friend has already written. By creating a new branch, you can safely work on top of the friend's progress.

Step 4: Create a new file

Go to contributions folder

cd contributors

Create a new file in that directory and fill in your info.

For example:

Name: Bruce Wayne
Github: [batman](https://github.com/batman)

Save as <your-name>.md

Step 5: Commit changes

If you finalise the changes you can store the changes permanently by two steps

  • add the changes
git add <filename>
  • commit the changes
git commit -m "Add <your-name> to contributors"

Step 6: Push changes

Push the changes to your repo by:

git push origin <your-branch-name>

From our example, we had already copied the files from the flash drive. We made some changes. Now we are copying back the changed file to flash drive so that we can give our changes to the friend.

Step 7: Create a pull request

Here you're giving the flash drive to your friend. So he/she can look into the changes you have made. If everything is good, he/she can have the changes you made to his/her project.

First, go to the GitHub repo in your account. Click Compare & pull request

And submit the pull request by clicking Create pull request

Hurray!

Congratulations, you have made it. Got any doubts? Feel free to let us know at our Discord!

Summary

 fork ----> clone ----> make changes -- +
                                        | 
create a PR <---- push <---- commit <-- +

Addditional resources

Check out this link if you would like to explore more!

This project was a part of FOSS OpenHack '20: https://openhack.gitbook.io/openhack-20/.

hello-opensource's People

Contributors

abhiramvanand avatar alwin48 avatar anandbaburajan avatar athuljoshi avatar ayshhh avatar breadgenie avatar btkcodedev avatar cgaswin avatar dency675 avatar ella311 avatar m6un avatar nayanajain avatar nehajetto avatar opatrickvico avatar roshan13046 avatar sakshi300699 avatar sauravlal15 avatar swapnalishipankar avatar twentyse7en avatar vipinvip avatar vishnusanal avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.