Skip to content

Commit

Permalink
Move tutorials using GUI tools to a directory
Browse files Browse the repository at this point in the history
  • Loading branch information
Roshan Jossy committed Sep 8, 2020
1 parent 684cfb1 commit a418c07
Show file tree
Hide file tree
Showing 10 changed files with 128 additions and 228 deletions.
2 changes: 1 addition & 1 deletion README.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -180,5 +180,5 @@ Now let's get you started with contributing to other projects. We've compiled a

| <a href="github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="gitkraken-tutorial.md"><img alt="GitKraken" src="./assets/gk-icon.png" width="100"></a> | <a href="github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a> | <a href="sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/d/d5/IntelliJ_IDEA_Logo.svg" width=100></a> |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| [GitHub Desktop](github-desktop-tutorial.md) | [Visual Studio 2017](github-windows-vs2017-tutorial.md) | [GitKraken](gitkraken-tutorial.md) | [Visual Studio Code](github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](sourcetree-macos-tutorial.md) | [IntelliJ IDEA](github-windows-intellij-tutorial.md) |
| [GitHub Desktop](gui-tool-tutorials/github-desktop-tutorial.md) | [Visual Studio 2017](gui-tool-tutorials/github-windows-vs2017-tutorial.md) | [GitKraken](gui-tool-tutorials/gitkraken-tutorial.md) | [Visual Studio Code](gui-tool-tutorials/github-windows-vs-code-tutorial.md) | [Atlassian Sourcetree](gui-tool-tutorials/sourcetree-macos-tutorial.md) | [IntelliJ IDEA](gui-tool-tutorials/github-windows-intellij-tutorial.md) |

45 changes: 16 additions & 29 deletions github-desktop-old-version-tutorial.md → ...ls/github-desktop-old-version-tutorial.md
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="assets/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[<img align="right" width="150" src="../assets/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)

Expand All @@ -13,7 +13,7 @@ It's hard. It's always hard the first time you do something. Especially when you

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.

<img align="right" width="300" src="assets/fork.png" alt="fork this repository" />
<img align="right" width="300" src="../assets/fork.png" alt="fork this repository" />

If you don't have GitHub Desktop on your machine, [install it](https://desktop.github.com/).

Expand All @@ -28,37 +28,37 @@ Now clone this repo to your machine.

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

<img style="float: right;" src="assets/dt-clone1.png" alt="clone this repository" />
<img style="float: right;" src="../assets/dt-clone1.png" alt="clone this repository" />

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

<img style="float: right;" src="assets/dt-clone2.png" alt="clone this repository" />
<img style="float: right;" src="../assets/dt-clone2.png" alt="clone this repository" />

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

<img style="float: right;" src="assets/dt-clone3.png" alt="clone this repository" />
<img style="float: right;" src="../assets/dt-clone3.png" alt="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:

<img style="float: right;" src="assets/dt-branch1.png" alt="make a branch" />
<img style="float: right;" src="../assets/dt-branch1.png" alt="make a branch" />

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

Click on `Create new branch`

<img style="float: right;" src="assets/dt-branch2.png" alt="name your branch" />
<img style="float: right;" src="../assets/dt-branch2.png" alt="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.

<img style="float: right;" src="assets/dt-status.png" alt="check status" />
<img style="float: right;" src="../assets/dt-status.png" alt="check status" />

Now commit those changes:

Expand All @@ -68,54 +68,41 @@ Replace `<your-name>` with your name

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

<img style="float: right;" src="assets/dt-commit1.png" alt="commit your changes" />
<img style="float: right;" src="../assets/dt-commit1.png" alt="commit your changes" />

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

<img style="float: right;" src="assets/dt-commit2.png" alt="commit your changes" />
<img style="float: right;" src="../assets/dt-commit2.png" alt="commit your changes" />

## Push changes to github

Click the `Publish` button on the top right.

<img style="float: right;" src="assets/dt-publish1.png" alt="push your changes" />
<img style="float: right;" src="../assets/dt-publish1.png" alt="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.

<img style="float: right;" src="assets/compare-and-pull.png" alt="create a pull request" />
<img style="float: right;" src="../assets/compare-and-pull.png" alt="create a pull request" />

Now submit the pull request.

<img style="float: right;" src="assets/submit-pull-request.png" alt="submit pull request" />
<img style="float: right;" src="../assets/submit-pull-request.png" alt="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 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](https://roshanjossey.github.io/first-contributions/#social-share).
Celebrate your contribution and share it with your friends and followers by going to [web app](https://firstcontributions.github.io#social-share).

You could join our slack team in case you need any help or have any questions. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY).

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](https://roshanjossey.github.io/first-contributions/#project-list).

### [Additional material](additional-material/git_workflow_senarios/additional-material.md)
### [Additional material](../additional-material/git_workflow_senarios/additional-material.md)


## Tutorials Using Other Tools

|<a href="README.md"><img alt="Command Line" src="http://cdn.osxdaily.com/wp-content/uploads/2014/08/terminal-icon-osx-150x150.png" width="100"></a>|<a href="github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://www.visualstudio.com/wp-content/uploads/2017/11/microsoft-visual-studio.svg" width="100"></a>|<a href="gitkraken-tutorial.md"><img alt="GitKraken" src="/assets/gk-icon.png" width="100"></a>|<a href="github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/d/d5/IntelliJ_IDEA_Logo.svg" width=100></a>|
|---|---|---|---|
|[Command Line](README.md)|[Visual Studio 2017](github-windows-vs2017-tutorial.md)|[GitKraken](gitkraken-tutorial.md)|[IntelliJ IDEA](github-windows-intellij-tutorial.md)|

## Self-Promotion

If you liked this project, star it on [GitHub](https://github.com/Roshanjossey/first-contributions).
If you're feeling especially charitable, follow [Roshan](https://roshanjossey.github.io/) on
[Twitter](https://twitter.com/sudo__bangbang) and
[GitHub](https://github.com/roshanjossey).

<a href="http://saasgrids.com"> <img alt="http://saasgrids.com" src="assets/saasgrids-banner.png" width="500"></a>
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
48 changes: 17 additions & 31 deletions github-desktop-tutorial.md → ...tool-tutorials/github-desktop-tutorial.md
View file
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/)
[<img align="right" width="150" src="assets/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[<img align="right" width="150" src="../assets/join-slack-team.png">](https://join.slack.com/t/firstcontributors/shared_invite/enQtNjkxNzQwNzA2MTMwLTVhMWJjNjg2ODRlNWZhNjIzYjgwNDIyZWYwZjhjYTQ4OTBjMWM0MmFhZDUxNzBiYzczMGNiYzcxNjkzZDZlMDM)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Open Source Helpers](https://www.codetriage.com/roshanjossey/first-contributions/badges/users.svg)](https://www.codetriage.com/roshanjossey/first-contributions)

Expand All @@ -17,7 +17,7 @@ If you don't have GitHub Desktop on your machine, [install it](https://desktop.g

If you're using a version of GitHub desktop before 1.0, [refer this tutorial](github-desktop-old-version-tutorial.md).

<img align="right" width="300" src="assets/fork.png" alt="fork this repository" />
<img align="right" width="300" src="../assets/fork.png" alt="fork this repository" />

## Fork this repository

Expand All @@ -32,27 +32,27 @@ IMPORTANT: DO NOT CLONE THE ORIGINAL REPO. Go to your fork and clone it.

To clone the repo, click on "Clone or Download" and then click on "Open in Desktop".

<img style="left;" src="assets/dt1-clonetodesktop.png" alt="clone this repository" />
<img style="left;" src="../assets/dt1-clonetodesktop.png" alt="clone this repository" />

A pop up window will open. Click on "Open GitHubDesktop.exe".

<img style="left;" src="assets/dt1-open-githubdesktop.png" alt="clone this repository" />
<img style="left;" src="../assets/dt1-open-githubdesktop.png" alt="clone this repository" />

After you click on "Open GitHubDesktop.exe" the contents will be downloaded to your computer.

<img style="left;" src="assets/dt1-downloaded.png" alt="clone this repository" />
<img style="left;" src="../assets/dt1-downloaded.png" alt="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 "Current branch" icon at the top and then click on "New branch":

<img style="left;" src="assets/dt1-create-branch.png" alt="make a branch" />
<img style="left;" src="../assets/dt1-create-branch.png" alt="make a branch" />

Name your branch <add-your-name>. For example, "add-james-smith"

<img style="left;" src="assets/dt1-create-branch-name.png" alt="name your branch" />
<img style="left;" src="../assets/dt1-create-branch-name.png" alt="name your branch" />

Click on `Create branch`

Expand All @@ -66,7 +66,7 @@ Example: If your name is James Smith, It should look like this.

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

<img style="left;" src="assets/dt1-status.png" alt="check status" />
<img style="left;" src="../assets/dt1-status.png" alt="check status" />

Now commit those changes:

Expand All @@ -76,58 +76,44 @@ Replace `<your-name>` with your name.

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

<img style="left;" src="assets/dt1-commit1.png" alt="commit your changes" />
<img style="left;" src="../assets/dt1-commit1.png" alt="commit your changes" />

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

<img style="left;" src="assets/dt1-commit2.png" alt="commit your changes" />
<img style="left;" src="../assets/dt1-commit2.png" alt="commit your changes" />

## Push changes to github

Click on File->Options and sign-in to Github.com. Type in your Github username and password.

<img style="left;" src="assets/dt1-sign-in.png" alt="log-in to Github" />
<img style="left;" src="../assets/dt1-sign-in.png" alt="log-in to Github" />

Click the `Publish` button on the top right.

<img style="left;" src="assets/dt1-publish1.png" alt="push your changes" />
<img style="left;" src="../assets/dt1-publish1.png" alt="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.

<img style="left;" src="assets/compare-and-pull.png" alt="create a pull request" />
<img style="left;" src="../assets/compare-and-pull.png" alt="create a pull request" />

Now submit the pull request.

<img style="left;" src="assets/submit-pull-request.png" alt="submit pull request" />
<img style="left;" src="../assets/submit-pull-request.png" alt="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 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](https://roshanjossey.github.io/first-contributions/#social-share).
Celebrate your contribution and share it with your friends and followers by going to [web app](https://firstcontributions.github.io#social-share).

You can join our slack team in case you need any help or have any questions. [Join slack team](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYzVkMzI1ZmVmOWI4ODdkZWQwNTM2NDVmNjY).

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](https://roshanjossey.github.io/first-contributions/#project-list).

### [Additional material](additional-material/git_workflow_senarios/additional-material.md)

### [Additional material](../additional-material/git_workflow_senarios/additional-material.md)

## Tutorials Using Other Tools

|<a href="README.md"><img alt="Command Line" src="http://cdn.osxdaily.com/wp-content/uploads/2014/08/terminal-icon-osx-150x150.png" width="100"></a>|<a href="github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a>|<a href="gitkraken-tutorial.md"><img alt="GitKraken" src="/assets/gk-icon.png" width="100"></a>|<a href="github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a>|<a href="sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a>|<a href="github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/d/d5/IntelliJ_IDEA_Logo.svg" width=100></a>|
|---|---|---|---|---|---|
|[Command Line](README.md)|[Visual Studio 2017](github-windows-vs2017-tutorial.md)|[GitKraken](gitkraken-tutorial.md)|[Visual Studio Code](github-windows-vs-code-tutorial.md)|[Atlassian Sourcetree](sourcetree-macos-tutorial.md)|[IntelliJ IDEA](github-windows-intellij-tutorial.md)|

## Self-Promotion

If you liked this project, star it on [GitHub](https://github.com/Roshanjossey/first-contributions).
If you're feeling especially charitable, follow [Roshan](https://roshanjossey.github.io/) on
[Twitter](https://twitter.com/sudo__bangbang) and
[GitHub](https://github.com/roshanjossey).

<a href="http://saasgrids.com"> <img alt="http://saasgrids.com" src="assets/saasgrids-banner.png" width="500"></a>
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)
Loading

0 comments on commit a418c07

Please sign in to comment.