README.hr.md

Prvi doprinosi

Ovaj projekt ima za cilj pojednostaviti i usmjeriti početnike daju svoj prvi doprinos (eng. contribution). Ako želite dati svoj prvi doprinos, slijedite ispod navedene korake.

Ukoliko niste bas sigurni u vas rad sa komandnom linijom/terminalom (terminal -> za macOs), mozete koristit ovaj link kroz GUI alate.

Ako niste upoznati s komandnom linijom, evo tutorijala za GUI alate.

Ako nemate git instaliran na vašem računalu, instalirajte ga ovdje.

Forkajte ovaj repozitorij

Forkajte ovaj repozitorij klikom na dugme fork na vrhu stranice. Ovim potezom napravit ćete kopiju repozitorija na vašem računu.

Klonirajte repozitorij

Nadalje, klonirajte repozitorij koji ste prethodno forkali. Posjetite svoj GitHub profil, otvorite repozitorij koji ste forkali, kliknite na code dugme, a zatim na ikonicu copy to clipboard.

Otvorite terminal i upišite sljedeće git naredbe:

git clone "url koji ste upravo kopirali"

gdje je "url koji ste upravo kopirali" (bez navodnika) poveznica na ovaj repozitorij (Vaš fork ovog projekta). Pogledajte prethodne korake za dohvaćanje url-a.

Na primjer:

git clone https://github.com/ovo-ste-vi/first-contributions.git

gdje je ovo-ste-vi Vaše GitHub korisničko ime. Ovim kopirate sadržaj repozitorija first-contributions na Vaše računalo.

Izrada grane

Prebacite se u radni direktorij na Vašem računalu (ako već niste tu):

cd first-contributions

Pa zatim napravite novu granu koristeći git checkout naredbu:

git checkout -b <ime-nove-grane>

Na primjer:

git checkout -b add-zoran-milanovic

(Naziv grane ne mora sadržavati riječ add u sebi, ali je zgodno uključiti ga jer je svrha ove grane dodavanje Vašeg imena na listu.)

Napravite potrebne izmjene i potvrdite promjene

Otvorite Contributors.md datoteku u uređivaču teksta i dodajte Vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negdje u sredinu. Zatim spremite datoteku.

Ako odete u radni direktorij i izvršite naredbu git status, primijetit ćete da postoje promjene.

Dodajte ove promjene u granu koju ste gore napravili koristeći git add naredbu:

git add Contributors.md

Sad potvrdite ove promjene koristeći git commit naredbu:

git commit -m "Add <tvoje-ime> to Contributors list"

gdje umjesto <tvoje-ime> upisujete svoje ime.

Priložite promjene na GitHub

Priložite izmjene u repozitoriju na GitHub koristeći git push:

git push origin <dodaj-ime-svoje-grane>

gdje umjesto <dodaj-ime-svoje-grane> stavljate ime Vaše grane koje ste prethodno napravili.

Pošaljite izmjene na pregled

Ako odete na repozitorij na Vašem GitHub profilu primijetit ćete Compare & pull request dugme. Kliknite na njega.

a potom pošaljite zahtjev klikom na dugme Create pull request.

Nakon toga, admin će spojiti promjene koje ste napravili s master granom projekta. Dobit ćete mail potvrde kada se grane spoje.

Što dalje?

Čestitamo! Završili ste standardni fork -> clone -> edit -> PR tijek koji će Vas pratiti kroz Vaš čitav programerski život!

Proslavite tako što ćete podjeliti Vaš doprinos s prijateljima i pratiteljima otvaranjem stranice.

Pridružite se i našem Slack timu u slučaju da Vam je potrebna ikakva pomoć ili imate bilo kakvih pitanja. Slack tim.

A sada, možemo početi s doprinosima drugim projektima. Napravili smo popis projekata s jednostavnim problemima na kojima možete početi s radom. Posjetite stranicu s the list of projects na našoj stranici.

Dodatni materijali

Upute za druge alate

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code	Atlassian Sourcetree	IntelliJ IDEA