diff --git a/Content.html b/Content.html index f892f4e..5f0df03 100644 --- a/Content.html +++ b/Content.html @@ -3,8 +3,8 @@ README.md - - - - + + - - + + + + -

Open Source Love

-

badge

-

KickOff To Open Source

-

First time open source seems very confusing. Beginners are generally overwhelmed and say "What Is This!?".

-

So, here's a practise environment for your first contribution smile

-

Also, you can see the presentation slides of Kickoff To Opensource here: madhavbahl.tech/opensource/

-

Let's Start!

-

STEP 1: Find The Project You Want To Contribute To

-

First step for starting open source is obviously, finding an open source project to contribute to!

-

Either you can go for contributing the project os some open source organisation like fossasia etc.

-

Or, you can find your projects/issues you want ot work on from these websites.

- -

By now, you must have found your required project/issue.

-

This is a first timers only repo which can be used to make your first open source contribution. We will write our username and description in the CONTRIBUTORS.md file and make a PR.

-

Congratulations! you just finished STEP 1

-

STEP 2: Fork The Repository

-

Fork this repo by clicking on the fork button on the top of the page. This will create a copy of this repository in your account.

-

image

-

STEP 3: Clone The Repository

-

Clone this repo to your machine. Go to your GitHub account, click on the clone button and then click the copy to clipboard icon.

-

Open a terminal and run the following git command:

-
git clone "Copied URL" -
- -

STEP 4: Create A Branch

-

Go to the directory where you cloned the repo.

-

Create a new branch using git checkout command

-
git checkout -b <branch-name> -
-

for keeping a standard, let's have the name of branch as username

-

for example:

-
git checkout -b MadhavBahlMD -
- -

STEP 5: Make Changes! Resolve Issue! Commit Those Changes! Push To GitHub!

-

Make the necessary changes, commit and push your code to GitHub.

-

Here, we are adding our username, name and bio in the CONTRIBUTORS.md

-

To make commit and push changes,

-
git add . - -git commit -m "Add [username] as a contributor" - -git push origin <branch name> -
- -

STEP 6: Open a Pull Request

-

If you go to your repository on GitHub, you'll see a Compare & pull request button. Click on that button.

-

Now submit the pull request!

-

Soon your changes will be reviewed and the PR will be merged if the changes are legit!

- -

Congrats

-

You just made your first PR.

-

Welcome to the world of open source

-

Additional Details: Keeping your fork synced with original repository

-

First of all, switch to the master branch, master branch is the main working branch which is supposed to have most updated code!

-
git checkout master -
-

Now, add original repo's url as a new remote, say original

-
git remote add original git@github.com:Logic-Xcution/Kickoff-To-Open-Source.git -
-

This is a way of telling git that another version of this project exists in the specified url and we’re calling it original. Once the changes are merged, fetch the new version of original repository.

-
git fetch original -
-

Now, you need to merge the new revision of my repository into your master branch.

-
git rebase original/master -
-

Now you can push these changes to your GitHub repo:

-
git push origin master -
-

Also, since your changes are merged and your repo is updated, the branch you created for your contribution is no longer required and you can delete it!

-
git branch -d <brach-name> -
-
git push origin --delete <branch-name> -
-

All The Best!

-

Now you know how to contribute to open source, go ahead champ!

+

Open Source Love

+

badge

+

KickOff To Open Source

+

First time open source seems very confusing. Beginners are generally overwhelmed and say "What Is This!?".

+

So, here's a practise environment for your first contribution smile

+

Also, you can see the presentation slides of Kickoff To Opensource here: madhavbahl.tech/opensource/

+

Let's Start!

+

STEP 1: Find The Project You Want To Contribute To

+

First step for starting open source is obviously, finding an open source project to contribute to!

+

Either you can go for contributing the project os some open source organisation like fossasia etc.

+

Or, you can find your projects/issues you want ot work on from these websites.

+ +

By now, you must have found your required project/issue.

+

This is a first timers only repo which can be used to make your first open source contribution. We will write our username and description in the CONTRIBUTORS.md file and make a PR.

+

Congratulations! you just finished STEP 1

+

STEP 2: Fork The Repository

+

Fork this repo by clicking on the fork button on the top of the page. This will create a copy of this repository in your account.

+

image

+

STEP 3: Clone The Repository

+

Clone this repo to your machine. Go to your GitHub account, click on the clone button and then click the copy to clipboard icon.

+

Open a terminal and run the following git command:

+
git clone "Copied URL" +
+ +

STEP 4: Create A Branch

+

Go to the directory where you cloned the repo.

+

Create a new branch using git checkout command

+
git checkout -b <branch-name> +
+

for keeping a standard, let's have the name of branch as username

+

for example:

+
git checkout -b MadhavBahlMD +
+ +

STEP 5: Make Changes! Resolve Issue! Commit Those Changes! Push To GitHub!

+

Make the necessary changes, commit and push your code to GitHub.

+

Here, we are adding our username, name and bio in the CONTRIBUTORS.md

+

To make commit and push changes,

+
git add . + +git commit -m "Add [username] as a contributor" + +git push origin <branch name> +
+ +

STEP 6: Open a Pull Request

+

If you go to your repository on GitHub, you'll see a Compare & pull request button. Click on that button.

+

Now submit the pull request!

+

Soon your changes will be reviewed and the PR will be merged if the changes are legit!

+ +

Congrats

+

You just made your first PR.

+

Welcome to the world of open source

+

Additional Details: Keeping your fork synced with original repository

+

First of all, switch to the master branch, master branch is the main working branch which is supposed to have most updated code!

+
git checkout master +
+

Now, add original repo's url as a new remote, say original

+
git remote add original git@github.com:Logic-Xcution/Kickoff-To-Open-Source.git +
+

This is a way of telling git that another version of this project exists in the specified url and we’re calling it original. Once the changes are merged, fetch the new version of original repository.

+
git fetch original +
+

Now, you need to merge the new revision of my repository into your master branch.

+
git rebase original/master +
+

Now you can push these changes to your GitHub repo:

+
git push origin master +
+

Also, since your changes are merged and your repo is updated, the branch you created for your contribution is no longer required and you can delete it!

+
git branch -d <brach-name> +
+
git push origin --delete <branch-name> +
+

All The Best!

+

Now you know how to contribute to open source, go ahead champ!