diff --git a/cli-tool-tutorials/git-bash-windows-tutorial.md b/cli-tool-tutorials/git-bash-windows-tutorial.md index f1a1e511..fd6c8a43 100644 --- a/cli-tool-tutorials/git-bash-windows-tutorial.md +++ b/cli-tool-tutorials/git-bash-windows-tutorial.md @@ -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 | Git Bash | 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. -`copy string` +copy string Open the git bash application you just downloaded. It should look like the image down below if its on a windows machine. -`open git bash terminal` +open git bash terminal Go to the folder that you want to save this project on by uisng this command `cd ` -`cd into a folder` +cd into a folder Use the string you copied in the step above to clone the repository using this command `git clone ` -`clone the repository` +clone the repository Go to the directory where the repo is and open it up on vs code to make your changes. -`cd into the newly cloned repo` +cd into the newly cloned repo ## Create a branch @@ -62,7 +61,7 @@ git checkout -b Name your branch ``. For example, "add-james-smith" -`create a branch` +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` -`check the status` +check the status Now commit those changes: @@ -90,7 +89,7 @@ Then write a commit message by sing this command Replace `` with your name. -`commit changes` +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 ` -`push changes` +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. -create a pull request +create a pull request Now submit the pull request. -submit 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 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). diff --git a/gui-tool-tutorials/github-desktop-tutorial.md b/gui-tool-tutorials/github-desktop-tutorial.md index 0d5d7693..66155b00 100644 --- a/gui-tool-tutorials/github-desktop-tutorial.md +++ b/gui-tool-tutorials/github-desktop-tutorial.md @@ -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 -|GitHub Desktop|GitHub Desktop Edition| -|---|---| +| 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. @@ -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". -clone this repository +clone this repository A pop up window will open. Click on "Open GitHubDesktop.exe". -clone this repository +clone this repository After you click on "Open GitHubDesktop.exe" the contents will be downloaded to your computer. -clone this repository +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": -make a branch +make a branch Name your branch . For example, "add-james-smith" -name your branch +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. -check status +check status Now commit those changes: -Write the message "Add `` to Contributors list" in the *summary* field. +Write the message "Add `` to Contributors list" in the _summary_ field. Replace `` with your name. Click on the button that says `Commit to add-your-name`. -commit your changes +commit your changes At the bottom, you can see that the commit has been created. -commit your changes +commit your changes ## Push changes to github Click on File->Options and sign-in to Github.com. Type in your Github username and password. -log-in to Github +log-in to Github Click the `Publish` button on the top right. -push your changes +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. -create a pull request +create a pull request Now submit the pull request. -submit 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 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) diff --git a/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md b/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md index 6c50777c..b7280284 100644 --- a/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md +++ b/gui-tool-tutorials/translations/github-desktop-tutorial.ng_yr.md @@ -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ọ -|GitHub Desktop|GitHub Ojú-iṣẹ Edition| -|---|---| +| GitHub Desktop | 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). 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). 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ṣẹ". -clone this repository +clone this repository Ferese agbejade yoo ṣii. Tẹ "Ṣii GitHubDesktop.exe". -clone this repository +clone this repository Lẹhin ti o tẹ “Ṣii GitHubDesktop.exe” awọn akoonu naa yoo ṣe igbasilẹ si kọnputa rẹ. -clone this repository +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”: -name your branch +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. -check status +check status Bayi ṣe awọn ayipada wọnyi: -Kọ ifiranṣẹ naa "Ṣafikun `` si atokọ Awọn oluranlọwọ” ni aaye * akopọ *. +Kọ ifiranṣẹ naa "Ṣafikun `` si atokọ Awọn oluranlọwọ” ni aaye _ akopọ _. Ropo `` pẹlu orukọ rẹ. Tẹ bọtini ti o sọ 'Ṣe lati fi-orukọ-rẹ'. -commit your changes +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. - -wọle si Github +wọle si Github Tẹ bọtini 'Tẹjade' ni apa ọtun oke. -Titari awọn ayipada rẹ +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. -ṣẹda ibeere fifa +ṣẹda ibeere fifa Bayi fi ibeere fa silẹ. -fi ìbéèrè fa +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) diff --git a/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md b/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md index 2aa68ecf..83062f7e 100644 --- a/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md +++ b/gui-tool-tutorials/translations/github-desktop-tutorial.pt_br.md @@ -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 -|GitHub Desktop|GitHub Desktop Edition| -|---|---| +| GitHub Desktop | 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". -clone este repositório +clone este repositório Uma janela pop up vai aparecer. Clique em "Open GitHubDesktop.exe". -clone este repositório +clone este repositório Depois de clicar em "Open GitHubDesktop.exe" os arquivos serão baixados para o seu computador. -clone este repositório +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": -criar uma branch +criar uma branch Nomeie sua branch como . Por exemplo, "add-james-smith" -nomeie sua branch +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. -checar mudanças +checar mudanças Agora faça commit dessas alterações: -Escreva a mensagem "Add `` to Contributors list" no campo *sumary* +Escreva a mensagem "Add `` to Contributors list" no campo _sumary_ Substitua `` pelo seu nome. Clique no botão que diz `Commit to add-your-name`. -commit suas alterações +commit suas alterações Na parte inferior, você pode ver que o commit foi criado com sucesso. -commit suas alterações +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. -log-in no Github +log-in no Github Clique no botão `Publish` na parte superior direita. -push suas alterações +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 -criando um pull request +criando um pull request Agora envie o pull request. -enviando o pull request +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)