[![Open Source Love](https://firstcontributions.github.io/open-source-badges/badges/open-source-v1/open-source.svg)](https://github.com/firstcontributions/open-source-badges) [![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) # Ilkinji goşantlar Bu proýektiň maksady, GitHub-y täze öwrenýänlere ilkinji goşantlaryny (contribution) nädip goşup biljeklerini görkezmekdir. Kyn bolup biler. Täze bir işi ilkinji sapar etmek hemişe kyn bolýar. Başga kişiler bilen bilelikde işlemeli bolsaň, ýalňyşlyk etmäne çekinýäň we gorkýaň. Ýöne açyk çeşmäniň (open source) düýbünde başga adamlar bilen bilelikde işleşmek ýatýar. Biz açyk çeşme (open source) proýektlerine ilkinji sapar goşant goşjaklara ýol görkezip, olaryň ilkinji goşantlaryny has aňsatlaşdyrmak isleýäris. Blog postlary okamak ýa-da wideolary görüp öwrenmek kömek edip biler, ýöne bir zady edip öwrenmegiň ýerini tutup biljek zat ýok, şeýle dälmi? Eger ilkinji goşandyňyzy goşmak isleýän bolsaňyz, aşakdaky görkezmeleri yzarlaň. fork this repository

#### Eger kompýuteriňizde git ýok bolsa, [şu ýerden ýükläň](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Şu repositoryny forklaň Şu sahypanyň ýokarsynda duran fork düwmesine basyp şu repositoryny forklap bilýaňiz. Şunlukda, şu repositorynyň kopiýasy siziň hasabyňyzda bolyar. (Şu proýektiň eýesiniň hasabynda-da, siziň hasabyňyzda-da bolýar) ## Şu repositoryny klonlaň(clone) clone this repository

Indi, forklan repositoryny öz kompýuteriňize klonlaň(clone). Bu diýmek, ýaňy siziň github hasabyňyza kopiýasy gelen(forklan) şu proýekti oz kompyuteriňizde-de bir kopiýasyna eýe bolup bilýäňiz. Github hasabyňyza gidiň, forklan repositoryny açyň, code düwmesine basyň, soňra _copy to clipboard_ nyşanyna basyň. Terminaly açyp aşakdaky git buýruguny işlediň: ``` git clone "ýaňy kopiýa eden url-ňyz" ``` "ýaňy kopiýa eden url-ňyz"(goşa dyrnaksyz) şu repositorynyň url-y (şu proýektiň siziň eden forkuňyz).Url-ny almak üçin ýokarda görkezilenleri yzarlaň. copy URL to clipboard

Mysal üçin: ``` git clone https://github.com/ulanyjy-ady/first-contributions.git ``` `ulanyjy-ady` diýip duran bölegiň deregine siziň Githubdaky ulanyjy adyňyz. Şu ýerde, Githubdaky first-contributions repositorynyň içindäki ähli zatlary kompýuteriňize kopiýalaýarsyňyz. ## Şaha(branch) döretmek Repositorynyň duran papkasynda däl bolsaňyz, şol ýere gidiň: ``` cd first-contributions ``` Indi, `git switch` buýrugy arkaly täze şaha(branch) dörediň: ``` git switch -c siziň-täze-şahaňyzyň-ady ``` Mysal üçin: ``` git switch -c goş-ahmet-ahmedow ``` (Şahanyň adynda _goş_ sözüni hökman ýazmasaňyzam bolyar, ýöne bu şahanyň maksady adyňyzy goşant goşanlaryň hasabyna goşmak bolany üçin, _goş_ sözüni ulanmak düşnükli bolar) ## Gerekli üýtgeşmeleri edip, ol üýtgeşmeleri bellige almak (commit etmek). Indi, tekst redaktorynda(m.ü VSCode) `Contributors.md` faýlyny açyň, içinde iň soňunda adyňyzy giriziň we ýatda saklaň(save) ``` - [Adyňyz](https://github.com/ulanyjy-adyňyz) ``` Mysal üçin: ``` - [Ahmet Ahmedow](https://github.com/ahmetahmedow) ``` ```](``` arasynda boşluk ýokdur

Terminalda eger proýektiň duran ýerine gidip,```git status``` buýrugyny işletseňiz, şol ýerde bolan üýtgeşmeleri görýaňiz. ```git add ``` buýrugyny ulanyp şol üýtgeşmeleri ýokarda döreden şahamyza(branch) goşýas: ``` git add Contributors.md ``` Indi, `git commit` buýrugy arkaly şol üýtgeşmeleri bellige alyp(commit) goýýas: ``` git commit -m " goşant goşanlaryň hataryna girizildi" ``` `` diýen ýere öz adyňyzy ýazyň (BELLIK: açyk çeşme(open source) dünýäsinde dünýäniň her dürli ýerlerinden her dürli adamlar bilen bilelikde işleşýaniňiz üçin bellige alyş(commit) tekstini iňlis dilinde ýazyp bilýaňiz). ## Üýtgeşmeleri Githuba ibermek(Push) `git push` buýrugy arkaly üýtgeşmeleriňizi iberiň(push): ``` git push -u origin siziň-şahaňyzyň-ady ``` `siziň-şahaňyzyň-ady` bölegini ýokarda doreden şahaňyzyň ady bilen çalşyň. ## Üýtgeşmeleriňizi gözden geçirmek üçin ýollaň Eger Githubda şu repositoryňyza gitseňiz, `Compare & pull request` düwmesini görýäňiz. Şol düwmä basyň. create a pull request

Indi, Çekiş haýyşnamasyny(pull request) ýollaň. submit pull request

Basym, Eden ähli üýtgeşmeleriňizi gözden geçirip, proýektiň esasy şahasy(main branch) bilen birleşdirýäs. Üýtgeşmeler birleşdirilen soň, habarnama alarsyňyz. ## Mundan soň näme edip bilersiňiz? Gutlaýas! Siz standart goşant goşujy hökmünde kän gabat gelinýän _forklamak(fork) -> Klonlamak(clone) -> Üýtgetmek(edit) -> Çekiş haýyşnamasy(pull request)_ yzygiderliligini tamamladyňyz! Eden goşandyňyza begeniň we dostlaryňyz bilen paýlaşyň! [Bu baglanma](https://firstcontributions.github.io/#social-share) arkaly hem birnäçe gyzykly proýektlere öz goşandyňyzy goşup bilýäňiz. Eger-de islendik kömek gerek bolsa ýa-da soraglaryňyz bar bolsa [biziň Slack toparymyza](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA) goşulyp bilýaňiz. ### [Goşmaça maglumat](additional-material/git_workflow_scenarios/additional-material.md) ## Başga gurallar hakynda sapaklar (ýöne iňlis dilinde) |

| | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | [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) |

Bu proýektiň goldaýjysy: