[](https://github.com/ellerbrock/open-source-badges/)
[
](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)
[](https://opensource.org/licenses/MIT)
[](https://www.codetriage.com/roshanjossey/first-contributions)
# Awel Moucharaka
Fo9ma katbghi tbda chi 7aja jdida katkoun m39da flewl. Dik lkhouf anak tghlet ki3ssbek,5ossosan fach katkoun 5dam m3a nass o5rin. Walakin lblan dl open source w anak t5dm m3a nass f fra9i . Bghina , nsshlou 3likoum bach t3lmou tcharkou fchi projet open source b7al hada l awel mra .
Rah blan tb9a t9ra kifach dir wla tchouf des tutoriels , walakin wach machi 7ssen nwriwk ki der bla matghlet ? Had lprojet l hadaf dyalou howa y3tek nassa2i7 w 5lik 3a9l : koulma knti mheden , ghat3lem 7ssen. Ila knti 3wal der awel i3ana , tbe3 had l5otowat w ra atsde9lk . Kanwa3dk , ghay3jbek l7al.
Ila makanch 3ndk git f pc dyalk, [ Telechargeh ]( https://help.github.com/articles/set-up-git/ )mn had site.
## Jbed had repo l3endek (kismiwha hna Fork)
Brek 3la dik FORK kima kaybanlk f tswira bach twli 3ndek b7al version dyal repo f compte dyalk .
## Telecharger 3ndk repo (Kismiwha clone )
Daba ,cloner repo dyalk l pc 3ndk. Brek 3la bottona d Clone w copier dik lien (HTTPS houwa sahel) ra kayna bottona 7da lien katcopiehlk nichan .
7el daba cmd (ila knti f windows) wla terminal (ila kan 3ndk mac wla 5dam b linux) w copier had les commandes li ghanwrik :
```
git clone "dik lien li 3ad copieti"
```
3andak t5liha hakak hhh "dik lien li 3ad copieti" (bla douk "") kteb tma lien li copieti fhemni .
Atkoun b7al had chkel :
```
git clone https://github.com/smytk_dyal_github/first-contributions.git
```
rah `smytk_dyal_github` hia smya li nta dayr.
Daba nta fhad l5twa ghatelecharger ga3 had repo 3ndk f pc bach tbda tbeddel fiha.
## Swb branche jdida dyalk
Daba f cmd nit wla terminal , d5l l dik lmilf li 3ad telechargeti (kteb had l3iba la ma3rftich d5l manuellement ) :
```
cd first-contributions
```
Daba ha kifach ghatswb branch dyalk `git checkout` :
```
git checkout -b "smya_dlbranch"
```
Par exemple :
```
git checkout -b add-brahim
```
(Machi darori tder f smya add , walakin gha bach nfhmo 3lach zdtiha)
## Bdl fl file d Contributors
Daba d5el l fichier dyal `Contributors.md` fchi editeur , zid smytk w chi lien ila bghiti (3andak der chi7aja 5ayba). Ila ktbti daba f dik cmd/terminal `git status`, aybanulk l3ibat li bdlti. Daba zidhoum l branch dyalk add-brahim bhad l3iba dyal `git add` :
```
git add Contributors.md
```
Sauvegardeha b `git commit`:
```
git commit -m "Add to Contributors list"
```
der fblasst `` smytk dbss7 (brahim matalan).
## PUSHIIII
Daba ghatpushi had lmodofication li derti l github b `git push` :
```
git push origin
```
ana knt mssmiha add-brahim , nta bdlha bachma knti dayr .
## 7et les modifications bach ytchafo
Ila rj3ti l github atl9a dik l3iba dyal `Compare & pull request`
brek 3liha a5ay.
Sf brek 3liha bach tle3 lnass li mss2oulin 3la hadchi.
Chwia mbe3d matjm3 dik lmodifications li derti . Aywslk mail ki9ololk fih ra safi dkchi dyalk nadi.
branche main dyalk maghaytbdel fiha walou daba . Ila bghiti ta main dyalk ykoun msynchroniser tbe3 had les étapes.
## 5li main dyalk synchronisé m3a contributors
B3da rje3 lmain matb9ach fdik add-brahim
```
git checkout main
```
zid lien d repo as `upstream remote url` :
```
git remote add upstream https://github.com/smytk_d_github/first-contributions
```
Ghi dik changes ydaro , 5ssk moraha tjbd version jdida dyal repo dyalk:
```
git fetch upstream
```
Hna kan9lbo 3la ga3 tghyirat li kaynin f lfork dyalk nta (upstream remote). Daba 3ad 5ssk tjm3 had jdida m3a repo dyalk (main) :
```
git rebase upstream/main
```
Daba ga3 tghyirat kaynin fl main. ila pushiti modifications aydaro ta f fork dyalk :
```
git push origin main
```
Daba ra jm3na branch dyal `` m3a l main dyalna , w jm3na lmain dyalna m3a main dyalhom (yarbi tkoun fhmtini hh).Daba dik li drti flwl dyal `` mab9atch 3ndha fa2ida , ila bghiti t7ydha :
```
git branch -d
```
w ymklk t7yda ta mn repo li b3ida :
```
git push origin --delete
```
Machi darori t7yd lbranch walakin raha salat 5smtha ma3ndha lach tb9a tma .
## Tutoriels bchi twichyat o5rin
|
|
|
|
|
|
|
| --- | --- | --- | --- | --- | --- |
| [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) |
## Fin nmchi daba ?
Ymklkoum tjiw l slack fin kayna lfr9a d hadchi kaml , n9do n3awnokom w njawbo 3la chi ass2ila [Slack](https://join.slack.com/t/firstcontributors/shared_invite/zt-1hg51qkgm-Xc7HxhsiPYNN3ofX2_I8FA)