sosokker/first-contributions
1
0
Fork 0
mirror of https://github.com/Sosokker/first-contributions.git synced 2025-12-18 20:54:06 +01:00
Code Issues Actions Packages Projects Releases Wiki Activity

fix images display (#61509)

Browse Source
This commit is contained in:
Doston Nabotov 2022-12-06 17:52:51 +02:00 committed by GitHub
parent e99506fe66
commit 87de007686
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
4 changed files with 66 additions and 71 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
cli-tool-tutorials/git-bash-windows-tutorial.md
View File

@ -3,11 +3,10 @@
[![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)
# First Contributions
| <img alt="Git Bash" src="https://cdn.icon-icons.com/icons2/2699/PNG/512/git_scm_logo_icon_170096.png" width="200"> | Git Bash 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.
@ -30,27 +29,27 @@ IMPORTANT: DO NOT CLONE THE ORIGINAL REPO. Go to your fork and clone it.
To clone the repo, click on "Code" and then copy the string down below.
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-1.png" alt="copy string" />
Open the git bash application you just downloaded. It should look like the image down below if its on a windows machine.
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-1.png" alt="open git bash terminal" />
Go to the folder that you want to save this project on by uisng this command
`cd <folder>`
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-2.png" alt="cd into a folder" />
Use the string you copied in the step above to clone the repository using this command
`git clone <repo-url>`
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-clone-2.png" alt="clone the repository" />
Go to the directory where the repo is and open it up on vs code to make your changes.
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-terminal-3.png" alt="cd into the newly cloned repo" />
## Create a branch
@ -62,7 +61,7 @@ git checkout -b <branch-name>
Name your branch `<add-your-name>`. For example, "add-james-smith"
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-branch.png" alt="create a branch" />
## Make necessary changes and commit those changes
@ -76,7 +75,7 @@ You can see that there are changes to Contributors.md by simply running this com
`git status`
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-status.png" alt="check the status" />
Now commit those changes:
@ -90,7 +89,7 @@ Then write a commit message by sing this command
Replace `<your-name>` with your name.
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-commit.png" alt="commit changes" />
To see if your commit has been made you can run a simple `git log --oneline` command.
@ -100,23 +99,23 @@ Once you are done with the above steps you can push your changes by using this c
`git push origin <branch-name>`
`<img style="left" src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push changes" />`
<img src="https://firstcontributions.github.io/assets/cli-tool-tutorials/git-bash-windows-tutorial/gb-push.png" alt="push 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.
If you go to your repository on github, you'll see `Compare & pull request` button. click on that button.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
Now submit the pull request.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/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!
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://firstcontributions.github.io#social-share).

37
gui-tool-tutorials/github-desktop-tutorial.md
View File

@ -3,11 +3,10 @@
[![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)
# First Contributions
|<img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200">|GitHub Desktop Edition|
|---|---|
| <img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200"> | 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.
@ -32,15 +31,15 @@ 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="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone this repository" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone this repository" />
A pop up window will open. Click on "Open GitHubDesktop.exe".
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone this repository" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/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="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone this repository" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone this repository" />
Now you have copied the contents of the first-contributions repository in github to your computer.
@ -48,11 +47,11 @@ Now you have copied the contents of the first-contributions repository in github
Now create a branch by clicking on the "Current branch" icon at the top and then click on "New branch":
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch.png" alt="make a branch" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch.png" alt="make a branch" />
Name your branch <add-your-name>. For example, "add-james-smith"
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="name your branch" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="name your branch" />
Click on `Create branch`
@ -66,54 +65,54 @@ 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="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="check status" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="check status" />
Now commit those changes:
Write the message "Add `<your-name>` to Contributors list" in the *summary* field.
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`.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit your changes" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit your changes" />
At the bottom, you can see that the commit has been created.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit2.png" alt="commit your changes" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/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="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt="log-in to Github" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt="log-in to Github" />
Click the `Publish` button on the top right.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt="push your changes" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/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.
If you go to your repository on github, you'll see `Compare & pull request` button. click on that button.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="create a pull request" />
Now submit the pull request.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="submit pull request" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/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!
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://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/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
### [Additional material](../additional-material/git_workflow_scenarios/additional-material.md)
## Tutorials Using Other Tools
[Back to main page](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)

36
gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md
View File

@ -3,11 +3,10 @@
[![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)
# Awọn ẹbun akọkọ
|<img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200">|GitHub Ojú-iṣẹ Edition|
|---|---|
| <img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200"> | GitHub Ojú-iṣẹ Edition |
| ----------------------------------------------------------------------------------------------- | ---------------------- |
O le. O jẹ lile nigbagbogbo ni igba akọkọ ti o ṣe nkan. Paapa nigbati o ba n ṣe ifowosowopo, ṣiṣe awọn aṣiṣe kii ṣe nkan ti o ni itunu. Ṣugbọn orisun ṣiṣi jẹ gbogbo nipa ifowosowopo & ṣiṣẹ papọ. A fẹ lati jẹ ki o rọrun ni ọna ti awọn oluranlọwọ orisun-ìmọ tuntun kọ ẹkọ & ṣe alabapin fun igba akọkọ.
@ -15,7 +14,7 @@ Awọn nkan kika & wiwo awọn olukọni le ṣe iranlọwọ, ṣugbọn kini o
Ti o ko ba ni Ojú-iṣẹ GitHub lori ẹrọ rẹ, [fi sii] (https://desktop.github.com/).
Ti o ba n lo ẹya ti tabili GitHub ṣaaju 1.0, [tọkasi ikẹkọ yii](github-desktop-old-version-tutorial.md). <img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt=" orita ibi ipamọ yii" />
Ti o ba n lo ẹya ti tabili GitHub ṣaaju 1.0, [tọkasi ikẹkọ yii](github-desktop-old-version-tutorial.md). <img align="right" width="300" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/fork.png" alt=" orita ibi ipamọ yii" />
## Orita ibi ipamọ yii
@ -25,15 +24,15 @@ Fork repo yii nipa tite lori bọtini orita ni apa ọtun oke ti oju-iwe yii. Ey
Bayi clone repo yii si ẹrọ rẹ. PATAKI: MAA ṢE TI AWỌN REPO ORIGINAL. Lọ si orita rẹ ki o ṣe oniye rẹ. Lati ṣe oniye repo, tẹ lori "Clone tabi Download" ati lẹhinna tẹ "Ṣii ni Ojú-iṣẹ".
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone this repository" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone this repository" />
Ferese agbejade yoo ṣii. Tẹ "Ṣii GitHubDesktop.exe".
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone this repository" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone this repository" />
Lẹhin ti o tẹ “Ṣii GitHubDesktop.exe” awọn akoonu naa yoo ṣe igbasilẹ si kọnputa rẹ.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone this repository" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone this repository" />
Bayi o ti daakọ awọn akoonu ti ibi ipamọ awọn ifunni akọkọ ni github si kọnputa rẹ.
@ -41,7 +40,7 @@ Bayi o ti daakọ awọn akoonu ti ibi ipamọ awọn ifunni akọkọ ni github
Bayi ṣẹda ẹka kan nipa tite lori aami “Ẹka lọwọlọwọ” ni oke ati lẹhinna tẹ “Ẹka Tuntun”:
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="name your branch" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="name your branch" />
Tẹ 'Ṣẹda ẹka'
@ -51,17 +50,17 @@ Bayi ṣii faili `Contributors.md` ni olootu ọrọ, yi lọ si isalẹ ti oju-
Apeere: Ti orukọ rẹ ba jẹ James Smith, O yẹ ki o dabi eleyi. \[James Smith](https://github.com/jamessmith) O le rii pe awọn ayipada wa si Contributors.md ati pe wọn ti ṣafikun si Ojú-iṣẹ Github.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="check status" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="check status" />
Bayi ṣe awọn ayipada wọnyi:
Kọ ifiranṣẹ naa "Ṣafikun `<orukọ-orukọ rẹ>` si atokọ Awọn oluranlọwọ” ni aaye * akopọ *.
Kọ ifiranṣẹ naa "Ṣafikun `<orukọ-orukọ rẹ>` si atokọ Awọn oluranlọwọ” ni aaye _ akopọ _.
Ropo `<oruko-rẹ>` pẹlu orukọ rẹ.
Tẹ bọtini ti o sọ 'Ṣe lati fi-orukọ-rẹ'.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit your changes" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit your changes" />
Ni isalẹ, o le rii pe a ti ṣẹda ifaramọ naa.
@ -69,24 +68,23 @@ Ni isalẹ, o le rii pe a ti ṣẹda ifaramọ naa.
## Titari awọn ayipada si github
Tẹ Faili-> Awọn aṣayan ati wọle si Github.com. Tẹ orukọ olumulo Github ati ọrọ igbaniwọle sii.
Tẹ Faili-> Awọn aṣayan ati wọle si Github.com. Tẹ orukọ olumulo Github ati ọrọ igbaniwọle sii.
<img style="left;" src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt = "wọle si Github" />
<img src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt = "wọle si Github" />
Tẹ bọtini 'Tẹjade' ni apa ọtun oke.
<img style="left;" src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt = "Titari awọn ayipada rẹ" />
<img src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt = "Titari awọn ayipada rẹ" />
## Firanṣẹ awọn ayipada rẹ fun atunyẹwo
Ti o ba lọ si ibi ipamọ rẹ lori github, iwọ yoo rii bọtini 'Afiwe & fa ìbéèrè'. tẹ lori wipe bọtini.
<img style="left;" src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt = "ṣẹda ibeere fifa" />
<img src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt = "ṣẹda ibeere fifa" />
Bayi fi ibeere fa silẹ.
<img style="left;" src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt = "fi ìbéèrè fa" />
<img src = "https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt = "fi ìbéèrè fa" />
Laipẹ Emi yoo dapọ gbogbo awọn ayipada rẹ si ẹka ọga ti iṣẹ akanṣe yii. Iwọ yoo gba imeeli iwifunni ni kete ti awọn ayipada ba ti dapọ.
@ -97,10 +95,10 @@ Oriire! O kan pari boṣewa _fork -> oniye -> edit -> PR_ iṣan-iṣẹ ti iw
Ṣe ayẹyẹ ilowosi rẹ ki o pin pẹlu awọn ọrẹ ati awọn ọmọlẹyin rẹ nipa lilọ si [ohun elo wẹẹbu](https://firstcontributions.github.io#social-share).
O le darapọ mọ ẹgbẹ alailẹṣẹ wa ni ọran ti o nilo iranlọwọ eyikeyi tabi ni awọn ibeere eyikeyi.
[Darapọ mọ ẹgbẹ alailẹṣẹ](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYVk)
[Darapọ mọ ẹgbẹ alailẹṣẹ](https://join.slack.com/t/firstcontributors/shared_invite/enQtMzE1MTYwNzI3ODQ0LTZiMDA2OGI2NTYyNjM1MTFiNTc4YTRhZTg4OWZjMzA0ZWZmY2UxYVk)
### [Awọn ohun elo afikun](../additional-material/git_workflow_scenarios/additional-material.md)
## Awọn olukọni Lilo Awọn irinṣẹ miiran
[Pada si oju-iwe akọkọ](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)

35
gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md
View File

@ -3,13 +3,12 @@
[![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)
# First Contributions
|<img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200">|GitHub Desktop Edition|
|---|---|
| <img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="200"> | GitHub Desktop Edition |
| ----------------------------------------------------------------------------------------------- | ---------------------- |
É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros não é algo agradável. Mas *open source* (código aberto) se trata de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores *open source* aprendem e contribuem pela primeira vez.
É difícil. É sempre difícil fazer algo pela primeira vez. Especialmente quando se está colaborando, cometer erros não é algo agradável. Mas _open source_ (código aberto) se trata de colaboração e de trabalharmos juntos. Queremos simplificar a forma com que novos colaboradores _open source_ aprendem e contribuem pela primeira vez.
Ler artigos e ver tutoriais pode ajudar, mas o que é melhor do que realmente pôr a mão na massa em um ambiente prático? Este projeto visa guiar e simplificar a forma com que os novatos fazem a sua primeira contribuição. Se quiser fazer a sua primeira contribuição, siga os passos abaixo.
@ -32,15 +31,15 @@ IMPORTANTE: NÃO CLONE O REPOSITÓRIO ORIGINAL. Vá para o seu fork e clone.
Para clonar esse repositório, clique em "Clone or Download" e então clique em "Open in Desktop".
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone este repositório" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-clonetodesktop.png" alt="clone este repositório" />
Uma janela pop up vai aparecer. Clique em "Open GitHubDesktop.exe".
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone este repositório" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-open-githubdesktop.png" alt="clone este repositório" />
Depois de clicar em "Open GitHubDesktop.exe" os arquivos serão baixados para o seu computador.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone este repositório" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-downloaded.png" alt="clone este repositório" />
Agora você copiou os arquivos do repositório first-contributions no github para o seu computador.
@ -48,11 +47,11 @@ Agora você copiou os arquivos do repositório first-contributions no github par
Agora crie uma branch clicando na aba "Current branch" que fica no topo, depois clique em "New branch":
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch.png" alt="criar uma branch" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch.png" alt="criar uma branch" />
Nomeie sua branch como <add-your-name>. Por exemplo, "add-james-smith"
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="nomeie sua branch" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-create-branch-name.png" alt="nomeie sua branch" />
Clique em `Create branch`
@ -66,41 +65,41 @@ Exemplo: Se o seu nome for James Smith, Deve ficar parecido com isso.
Você pode ver as alterações feitas em Contributors.md no Github Desktop.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="checar mudanças" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-status.png" alt="checar mudanças" />
Agora faça commit dessas alterações:
Escreva a mensagem "Add `<your-name>` to Contributors list" no campo *sumary*
Escreva a mensagem "Add `<your-name>` to Contributors list" no campo _sumary_
Substitua `<your-name>` pelo seu nome.
Clique no botão que diz `Commit to add-your-name`.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit suas alterações" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit1.png" alt="commit suas alterações" />
Na parte inferior, você pode ver que o commit foi criado com sucesso.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit2.png" alt="commit suas alterações" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-commit2.png" alt="commit suas alterações" />
## Faça o push das mudanças no github
Clique em File -> Options e depois em sign-in to Github.com. Digite seu username e senha do Github.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt="log-in no Github" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-sign-in.png" alt="log-in no Github" />
Clique no botão `Publish` na parte superior direita.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt="push suas alterações" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/dt1-publish1.png" alt="push suas alterações" />
## Envie suas alterações para review
Se você for até seu repositório no github, verá o botão `Compare & pull request`. Clique nesse botão
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="criando um pull request" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/compare-and-pull.png" alt="criando um pull request" />
Agora envie o pull request.
<img style="left;" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="enviando o pull request" />
<img src="https://firstcontributions.github.io/assets/gui-tool-tutorials/github-desktop-tutorial/submit-pull-request.png" alt="enviando o pull request" />
Em breve estarei mesclando todas as suas alterações na branch Master do projeto. Você vai receber um email de notificação assim que as alterações forem integradas.
@ -112,8 +111,8 @@ Comemore sua contribuição e compartilhe com seus amigos e seguidores acessando
Você pode entrar na nossa equipe no Slack caso precise de alguma ajuda ou tenha alguma dúvida. [Entre no Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA).
### [Material adicional](../additional-material/git_workflow_senarios/additional-material.md)
## Tutoriais usando outras ferramentas
[Voltar a página principal](https://github.com/firstcontributions/first-contributions#tutorials-using-other-tools)