Skip to content

Latest commit

 

History

History
126 lines (70 loc) · 12.2 KB

github-desktop-tutorial.md

File metadata and controls

126 lines (70 loc) · 12.2 KB

Open Source Love

First Contributions

GitHub Desktop GitHub Desktop Edition

It's hard. It's always hard the first time you do something. 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.

fork this repository

If you don't have GitHub Desktop on your machine, install it.

Fork this repository

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

Clone the repository

Now clone this repo to your machine.

Open the GitHub Desktop app and click on the + on the top left.

clone this repository

If it is not already selected, click on Clone. Then choose first-contributions and then click on Clone first-contributions

clone this repository

Choose the directory on your machine you would like to clone first-contributions into

clone this repository

Now you have copied the contents of the first-contributions repository in github to your computer.

Create a branch

Now create a branch by clicking on the branch icon at the top left:

make a branch

Name your branch add-your-name. For example, add-crawleya

Click on Create new branch

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.

You can see that there are changes to Contributors.md and they have been added.

check status

Now commit those changes:

Write the message "Add <your-name> to Contributors list" in the summary field

Replace <your-name> with your name

Click on the button that says Commit to add-your-name

commit your changes

At the bottom, you can see that the commit has been created.

commit your changes

Push changes to github

Click the Publish button on the top right.

push your changes

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

Keeping your fork synced with this repository

Now I'll be merging all your changes into the master branch of this project. Your fork won't have those changes.

In order to keep your fork synced with mine, click Sync on the top right.

sync

When there are new commits to sync, click Update from Roshanjossey/master

sync

Hovering over Update from Roshanjossey/master will show you that you are up to date:

sync

Tutorials Using Other Tools

Command Line Visual Studio 2017 GitKraken
Command Line Visual Studio 2017 GitKraken

Where to go from here?

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

Here's some beginner level issues in popular repos that you can solve. Go ahead and go to those repos to learn more

exercism fun-retro habitat scikit-learn elasticsearch
exercism Fun Retros react habitat scikit-learn Leiningen numpy elasticsearch
homebrew rust vuejs Suave OpenRA PowerShell coala moment
homebrew Rust vuejs Suave OpenRA PowerShell coala moment
ava freeCodeCamp webpack hoodie pouchdb neovim babel
ava freeCodeCamp webpack hoodie pouchdb neovim babel brackets
Node.js
Node.js Semantic-UI-React