[![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) # Okwongezaako Eby'okusooka Ekigendererwa ky'enteekateeka eno kwe kusobozesa n'okuyamba abayizi mu kuteekawo ebyabwe eby'okubiri. Bw'oba oyagala okukola eky'osooka okuyongeraako, goberera emboozi ez'ekiddako wansi. _Bw'oba tokkiriziganya na command line, [wano waliyo ebiranga ebikozesa ebikozesebwa ebiwa GUI.](#tutorials-using-other-tools)_ fork this repository #### Bw'oba tolina git ku kompyuta yo, [teeka git](https://docs.github.com/en/get-started/quickstart/set-up-git). ## Gabaako repo eno Gabaako repo eno nga okozesa ekirungo ekiri waggulu ku lupapula luno. Kino kijja kutonda kopi ya repo eno mu akaawunti yo. ## Koppa repo clone this repository Kati koppa repo eyogabiddwa ku kompyuta yo. Genda ku akaawunti yo ku GitHub, fungula repo eyogabiddwa, koona ku kaakano akaliko code n'oluvannyuma koona ku kirungo _copy to clipboard_. Fungula terminal n'okozesa ekiragiro ekiddako ku git: ```bash git clone "url you just copied" ``` "URL gy'okoze koppa" (nga tekirina obubonero obuli mu kkiwandiiko) kye URL eri ku repo eno (okugaba kwo ku kawefube ono). Laba ku bigambo ebyo ebiri waggulu okugenda ku URL. copy URL to clipboard Ekikokyo: ```bash git clone git@github.com:this-is-you/first-contributions.git ``` awa `this-is-you` ye erinya lyo ku GitHub. Wano okopeera ebiri mu repo ey'okusooka okuyongeraako ku GitHub ku kompyuta yo. ## Tonda branch Kyusa mu nnannyini repo ku kompyuta yo (bw'oba toliyo dda): ```bash cd first-contributions ``` Kati tonda branch ng'oyita mu kiragiro kya `git switch`: ```bash git switch -c your-new-branch-name ``` Ekikokyo: ```bash git switch -c add-alonzo-church ``` ## Kola enkyukakyuka eziyetaagisa n'okikakasa ezo enkyukakyuka Kati gulawo fayiro ya `Contributors.md` mu kikozesebwa ky'okuwandiika, yongeramu erinnya lyo mu fayiro eno. Togyongeramu ku ntandikwa oba ku nkomerero ya fayiro. Tta gy'ali wakati wa fayiro. Kati, giyita fayiro eno. git status Bw'ogenda mu kisenge ky'enteekateeka n'okola ekiragiro `git status`, ojja kulaba nga waliyo enkyukakyuka. Yongeza ezo enkyukakyuka ku branch gye watondawo nga okozesa ekiragiro kya `git add`: ```bash git add Contributors.md ``` Kati okakasa ezo enkyukakyuka nga okozesa ekiragiro kya `git commit`: ```bash git commit -m "Add your-name to Contributors list" ``` oweerereza erinnya lyo ku `your-name`. ## Sindikiza enkyukakyuka ku GitHub Sindikiza enkyukakyuka nga okozesa ekiragiro kya `git push`: ```bash git push -u origin your-branch-name ``` oweerereza erinnya lyo ku `your-branch-name`. ## Weereza enkyukakyuka zo okuzuulibwa Bw'ogenda ku repo yo ku GitHub, ojja kulaba akapipati ka `Compare & pull request`. Koona ku kapipati ako. create a pull request Kati weereza pull request. submit pull request Olwatuuka kunsonga y'okukakasa enkyukakyuka zo, ojja kufuna email ya kunnyonnyola enkyukakyuka zomaze okukakasa. Oluvannyuma lw'okwo Ki ekirungi! Onoowuziza ku ttendekero lya _fork -> clone -> edit -> pull request_ workflow gwe oyinza okufuna ng'omukozi! Jaguza ekyo ky'oyongeddeko era ogikwase mikwano gyo n'abagoberera nga oyita ku [web app](https://firstcontributions.github.io/#social-share). Kati ka tutandikire okukola ku kintu ekirala. Tundese olukalala lwa project ezirina ebizibu ebitalina y'oyinza okutandika n'okukola. Kebera [olukalala lwa project mu web app](https://firstcontributions.github.io/#project-list). ### [Ebirala ebisobola okukuyamba](additional-material/git_workflow_scenarios/additional-material.md) ## Ebitendekebwa Ebikozesa Ebikozesebwa Ebirala | 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) |