Skip to content

Latest commit

 

History

History
121 lines (64 loc) · 7.19 KB

sublime-merge-tutorial.md

File metadata and controls

121 lines (64 loc) · 7.19 KB

Open Source Love License: MIT Open Source Helpers

First Contributions

Sublime Merge Sublime Merge Git Client

It's hard. It's always hard, when you do something for the first time. Especially when you are collaborating, making mistakes isn't a comfortable thing. But open source is all about collaboration & working together. We wanted to simplify the way new open-source contributors learn & contribute for the first time.

Reading articles & watching tutorials can help, but what comes better than actually doing the stuff without messing up anything. This project aims at providing guidance & simplifying the way rookies make their first contribution. Remember the more relaxed you are, the better you learn. If you are looking for making your first contribution just follow the simple steps below. We promise you, it will be fun.

Sublime Merge

Download Sublime Merge, Install and open it.

Fork this repository

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

Clone the repository

clone this repository

In Sublime Merge, go to File -> Clone Repository.

clone this repository

The next step is to clone your repo down to your machine so you can begin making changes. Sublime Merge needs the URL of your repo, so click the "clone" button and then click the "copy to clipboard" icon.

CAREFUL: One mistake that new contributors often make is to clone the repo you forked from rather than cloning your repo. Check your browser's address bar and make sure you are cloning your repo.

Enter the URL of the repo in Sublime Merge, give it a repository name (or leave it blank) and set your directory where to save the repository.

Once you're satisfied with the path, click "Clone".

Create a branch

Right click Branches -> Create Branch or Navigate to Repository -> Create Branch

Name your branch "add-your-name", for example: "add-william-sutton"

name your branch

Make necessary changes and commit those changes

Now open Contributors.md file in a text editor and add your name to it, then save the file.

If you have the repo open in Sublime Merge you'll see there are changes. Select the newest commit at the top, named "x unstaged files" Review the files that have been changed and decide what you would like to stage. Give the commit a commit message ("Add to Contributors list" sounds nice and descriptive). When you are happy with your changes stage those changes by staging them file by file or selecting "stage all". Staging is important to tell git exactly what file changes you want associated with this commit.

stage your changes

If you change your mind, you can unstage those changes, or you can discard them all together. WARNING: As the word discard implies, this is a destructive operation. Do this only if you don't want any change(s) from whatever repository you're in.

Hit commit and enter your username and email address and press Update.

Hit commit again.

Congratulations, you've committed all the changes to your local copy of your branch of your fork of first-contributions. Onward!

Push changes to GitHub

Navigate to Repository -> Push or hit the small arrow in upward direction in the right hand corner.

login

Login to your Github Account with your username and password

Submit changes on the origin branch if you want the changes to reflect in the master branch directly, else select the appropriate branch you want to push.

Submit your changes for review

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

create a pull request

Now submit the pull request.

submit pull request

Soon I'll be merging all your changes into the master branch of this project. You will get a notification email once the changes have been merged.

Where to go from here?

Congrats! You have just completed the standard fork -> clone -> edit -> PR workflow that you'll encounter often as a contributor!

Celebrate your contribution and share it with your friends and followers by going to web app.

You could join our slack team in case you need any help or have any questions. Join slack team.

Now let's get you started with contributing to other projects. We've compiled a list of projects with easy issues you can get started on. Check out the list of projects in web app.

Tutorials Using Other Tools

Command Line GitHub Desktop Visual Studio 2017 VS Code Sourcetree App IntelliJ IDEA
Command Line GitHub Desktop Visual Studio 2017 Visual Studio Code Atlassian Sourcetree IntelliJ IDEA