mirror of
https://github.com/LucasVbr/first-contributions.git
synced 2026-05-13 17:21:50 +00:00
Akshay Juneja
123 lines
8.0 KiB
Markdown
123 lines
8.0 KiB
Markdown
[](https://github.com/firstcontributions/open-source-badges)
|
|
[](https://opensource.org/licenses/MIT)
|
|
[](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)_
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/fork.png" alt="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
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/clone.png" alt="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.
|
|
|
|
<img align="right" width="300" src="https://firstcontributions.github.io/assets/Readme/copy-to-clipboard.png" alt="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.
|
|
|
|
<img align="right" width="450" src="https://firstcontributions.github.io/assets/Readme/git-status.png" alt="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.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/compare-and-pull.png" alt="create a pull request" />
|
|
|
|
Kati weereza pull request.
|
|
|
|
<img style="float: right;" src="https://firstcontributions.github.io/assets/Readme/submit-pull-request.png" alt="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
|
|
|
|
| <a href="gui-tool-tutorials/github-desktop-tutorial.md"><img alt="GitHub Desktop" src="https://desktop.github.com/images/desktop-icon.svg" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs2017-tutorial.md"><img alt="Visual Studio 2017" src="https://upload.wikimedia.org/wikipedia/commons/c/cd/Visual_Studio_2017_Logo.svg" width="100"></a> | <a href="gui-tool-tutorials/gitkraken-tutorial.md"><img alt="GitKraken" src="https://firstcontributions.github.io/assets/gui-tool-tutorials/gitkraken-tutorial/gk-icon.png" width="100"></a> | <a href="gui-tool-tutorials/github-windows-vs-code-tutorial.md"><img alt="VS Code" src="https://upload.wikimedia.org/wikipedia/commons/2/2d/Visual_Studio_Code_1.18_icon.svg" width=100></a> | <a href="gui-tool-tutorials/sourcetree-macos-tutorial.md"><img alt="Sourcetree App" src="https://wac-cdn.atlassian.com/dam/jcr:81b15cde-be2e-4f4a-8af7-9436f4a1b431/Sourcetree-icon-blue.svg" width=100></a> | <a href="gui-tool-tutorials/github-windows-intellij-tutorial.md"><img alt="IntelliJ IDEA" src="https://upload.wikimedia.org/wikipedia/commons/thumb/9/9c/IntelliJ_IDEA_Icon.svg/512px-IntelliJ_IDEA_Icon.svg.png" width=100></a> |
|
|
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
|
| [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) |
|
|
|