[![Open Source Love](https://badges.frapsoft.com/os/v1/open-source.svg?v=103)](https://github.com/ellerbrock/open-source-badges/) [](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) [![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) # Iminikelo Yokuqala Sifuna ukusiza nokubonisa abanikeli abasha indlela yokuqala ngokunikela. Uma ufuna ukunikela kokuqala, landela lezinyathelo ezilandelayo. #### *Uma ungakhululekile ngomugqa womyalo, [nazi izifundo ezisebenzisa amathuluzi we-GUI.](#Izinto-ezengeziwe)* fork this repository Uma ungenayo i-git kumshini wakho, [ifake]( https://help.github.com/articles/set-up-git/). ## Fometha le ndawo yokugcina Fometha le repo ngokuchofoza inkinobho yemfoloko phezulu kwaleli khasi. Lokhu kuzokhipha ikhophi yalesi sikhwama ku-akhawunti yakho. ## Qalisa i-repository clone this repository Manje faka i-repo efakwe emshini wakho kumshini wakho. Yiya ku-akhawunti yakho ye-GitHub, vula i-repo evuliwe, chofoza inkinobho ye-clone bese uchofoza ikhophi ku-clipboard icon. Vula i-console bese ugijima umyalo we-git: ```bash git clone "url you just copied" ``` lapho "u-url osuvele ukopishe khona" (ngaphandle kwama-quote marks) yi-url kule ndawo yokugcina (ifomu lakho lephrojekthi). Bona izinyathelo zangaphambilini ukuthola i-url. copy URL to clipboard Ngokwesibonelo: ```bash git clone https://github.com/this-is-you/first-contributions.git ``` La kubalwe `this-is-you` faka i-username yakho yaku GitHub. Lapha ukopisha okuqukethwe kokulondoloza kokuqala ku-GitHub kwikhompyutha yakho. ## Dala igatsha Shintsha kwirekhodi lokugcina ekhompyutheni yakho (uma ungasekho kakade): ```bash cd first-contributions ``` Manje dala igatsha usebenzisa `git checkout` umyalo: ```bash git checkout -b ``` Ngokwesibonelo ```bash git checkout -b engeza-adam-kowalski ``` (Igama legatsha alidingi ukuba izwi engeza kuwo, kodwa into enengqondo ukufaka ngoba inhloso yaleli gatsha ukwengeza igama lakho uhlu.) ## Yenza ushintsho oludingekile bese wenza lezo zinguquko Manje `Contributors.md` ifayela evulekile kumhleli wombhalo, engeza igama lakho kuyo. Ungayifaki ekuqaleni noma ekupheleni kwefayela. Beka noma kuphi phakathi. Manje, londoloza ifayela. git status Uma uya encwadini yomhlahlandlela bese wenza umyalo `git status`, uzobona kukhona izinguquko. Engeza lezo zinguquko egatsheni owake wadala usebenzisa `git add` umyalo: ```bash git add Contributors.md ``` Manje yenza lezo zinguquko usebenzisa `git commit` umyalo: ```bash git commit -m "Add to Contributors list" ``` ukufaka esikhundleni `` ngegama lakho. ## Shintsha izinguquko ku-GitHub Pusha izinguquko zakho ngokusebenzisa umyalo `git push`: ```bash git push origin ``` kufaka esikhundleni `` igama legatsha owadala ngaphambilini. ## Thumela izinguquko zakho ukuze zibuyekezwe Uma uya endaweni yakho yokugcina ku-GitHub, uzobona `Compare & pull request` inkinobho. Chofoza kuleyo nkinobho. create a pull request Manje thumela isicelo sokudonsa. submit pull request Ngizohlanganisa zonke izinguquko zakho ngokushesha zibe yigatsha eliyinhloko laphrojekthi. Uzothola i-imeyili yesaziso uma izinguquko sezihlanganisiwe. ## Ungaphi lapho? Siyakuhalalisela! Usanda kuqedela umshini ojwayelekile -> clone -> edit -> PR ukuhamba komsebenzi ozohlangana ngaso sonke isikhathi njengomnikelo! Gubha umnikelo wakho bese uwabelana nabangani bakho nabalandeli ngokuya kuhlelo [lokusebenza lewebhu](https://firstcontributions.github.io/#social-share). Ungakwazi ukujoyina ithimba lethu elihle uma kwenzeka udinga noma yiluphi usizo noma unemibuzo. [Joyina ithimba le-slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA). Manje ake siqale ngokunikela ngeminye imiklamo. Senze uhlu lwamaphrojekthi ngezinkinga ezilula ongaqala ngazo. Hlola [uhlu lwamaphrojekthi kuhlelo lokusebenza lewebhu .](https://firstcontributions.github.io/#project-list). ### [Izinto ezengeziwe](../additional-material/git_workflow_scenarios/additional-material.md) ## Izinto ezengeziwe | GitHub Desktop | Visual Studio 2017 | GitKraken | VS Code | Sourcetree App | IntelliJ IDEA | | --- | --- | --- | --- | --- | --- | | [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) |