Pročitaj ovo na drugim jezicima.

Prvi doprinos (eng. contribution)

Ovaj projekat ima za cilj da uputi početnike kako da jednostavno naprave svoj prvi doprinos. Ako tražite kako da napravite svoj prvi doprinos, pratite korake ispod.

Ako vam je nezgodno da koristite komandnu liniju, evo uputstva za GUI alate.

Ukoliko nemate git na vašoj mašini, instalirajte ga.

Napraviti fork ovog repozitorijuma

Napravite fork ovog repozitorijuma klikom na fork dugme na vrhu ove stranice. To će napraviti kopiju ovog repozitorijuma na Vašem nalogu.

Klonirati repozitorijum

Sada klonirajte fork-ovani repozitorijum na vašu mašinu. Otvorite svoj GitHub profil, otvorite repozitorijum koji ste fork-ovali, kliknite na dugme code, onda na SSH tab, a onda kliknite copy url to clipboard ikonicu.

Otvorite terminal i pokrenite sledeću git komandu:

git clone "url you just copied"

Umesto "url you just copied" (bez navodnika) upišite url ovog repozitorijuma (vašeg fork-a ovog projekta). Pogledajte prethodne korake da biste dobavili url.

Na primer:

git clone git@github.com:this-is-you/first-contributions.git

gde this-is-you predstavlja vaše GitHub korisničko ime. Ovim kopirate sadržaj first-contributions repozitorijuma na GitHub-u na vaš računar.

Napraviti granu

Pozicionirajte se u direktorijum repozitorijuma na Vašem računaru (ako već niste tamo):

cd first-contributions

Napravite granu upotrebom git switch komande:

git switch -c your-new-branch-name

Na primer:

git switch -c add-alonzo-church

Ako dobijate greške prilikom upotrebe git switch, kliknite ovde:

Ako poruka greške glasi "Git: switch is not a git command. See git –help", verovatno koristite stariju verziju git-a.

U ovom slučaju, probajte da koristite git checkout:

git checkout -b your-new-branch-name

Napravite potrebne izmene i commit-ujte ih

Otvorite Contributors.md fajl u tekstualnom editoru i dodajte svoje ime. Nemojte dodavati ime na sam početak ili kraj. Dodajte ga negde u sredinu. Potom sačuvajte fajl.

Ukoliko odete u direktorijum projekta i izvršite komandu git status, primetićete da postoje izmene.

Dodajte ove izmene na granu koju ste upravo napravili upotrebom git add komande:

git add Contributors.md

Sada commit-ujte te izmene pomoću git commit komande:

git commit -m "Add your-name to Contributors list"

zamenjujući your-name sa Vašim imenom.

Push-ovanje izmena na GitHub

Push-ujte svoje izmene upotrebom komande git push:

git push -u origin your-branch-name

zamenjujući your-branch-name sa imenom grane koju ste ranije napravili.

Ako dobijate greške prilikom push-ovanja, kliknite ovde:

Greška prilikom autentifikacije

remote: Support for password authentication was removed on August 13, 2021. Please use a personal access token instead.
remote: Please see https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information.
fatal: Authentication failed for 'https://github.com//first-contributions.git/'

Pogledajte GitHub-ov tutorijal za generisanje i konfiguraciju SSH ključa za Vaš nalog.

Takođe, možda ćete želeti da izvršite 'git remote -v' da biste proverili Vašu udaljenu adresu.

Ako liči na ovo:

origin	https://github.com/your-username/your_repo.git (fetch)
origin	https://github.com/your-username/your_repo.git (push)

izvršite ovu komandu:

git remote set-url origin git@github.com:your-username/your_repo.git

U suprotnom će Vam se tražiti korisničko ime i lozinka i dobijaćete grešku prilikom autentifikacije.

Pošaljite izmene na reviziju (eng. review)

Ako odete na Vaš repozitorijum na GitHub-u, primetićete Compare & pull request dugme. Kliknite na njega.

Sada pošaljite pull request.

Nedugo nakon toga ću ja spojiti (eng. merge) izmene koje Ste napravili sa master granom ovog projekta. Dobićete obaveštenje na email kada izmene budu spojene.

Šta dalje?

Čestitamo! Završili ste standardni fork -> clone -> edit -> pull request tok razvoja (eng. workflow) sa kojim ćete se često susretati kao saradnik!

Proslavite svoj doprinos sa prijateljima i pratiocima tako što ćete otići na ovaj sajt.

Ako želite još vežbe, pogledajte code contributions.

A sada, hajde da počnete sa doprinosom na drugim projektima. Napravili smo spisak projekata sa jednostavnim problemima na kojima možete početi da radite. Pogledajte spisak projekata na sajtu.