README.bih.md

Prvi doprinosi

Ovaj projekat ima za cilj da pruži konkretne korake i olakša način na koji početnici prilažu svoje prve doprinose (eng. contributions). Ukoliko ste se prepoznali u tekstu iznad i zelite da probate i doprinesete ovome ili nekom drugom projektu, pratite slijedece korake.

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

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

Uradite fork repozitorijuma

Uradite račvanje (fork) tako što ćete kliknuti na dugme fork na vrhu stranice. Ovako pravite kopiju repozitorijuma na vašoj github stranici.

Klonirajte repozitorijum

Slijedeće, klonirajte repozitorijum koji ste prethodno račvali (fork). Posjetite svoj GitHub profil, otvorite repozitorijum koji ste račvali, kliknite na clone (kloniraj/kopiraj) dugme i kliknite na ikonicu copy to clipboard.

Otvorite terminal i upišite slijedece git komande:

git clone "url koji ste prethodno kopirali sa vaseg github profila" (bez navodnika i razmaka)

Na primjer:

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

Gdje je umjesto ovo-ste-vi upisano vaše github korisničko ime. Ovim kopirate sadržaj repozitorijuma first-contributions na vašu mašinu.

Pravljenje grane branch

Prebacite se u radni direktorij na vašoj mašini:

cd first-contributions (ili pratite gdje se tacno nalazi na vasoj masini)

Pa zatim napravite novo grananje branch koristeći git checkout comandu:

git checkout -b <add-svoje-ime>

Na primer:

git checkout -b add-alonzo-church

(Naziv grane ne mora da sadrži add na početku ili vase ime, ali je zgodno uključiti ga jer je svrha ove grane da doda vaše ime na listu.

Napravite potrebne izmjene i potvrdite promjene

Otvorite Contributors.md fajl u tekst editoru i dodajte vaše ime. Nemojte dodavati ime na sam početak ili kraj. Stavite ga negdje u sredinu. Potom sačuvajte fajl.

Ukoliko odete u radni direktorijum i izvršite komandu git status, primjetit ce te da postoje promjene.

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

git add Contributors.md

Sada potvrdite ove promjene koristeći git commit komandu:

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

Gdje umjesto <tvoje-ime> upisujete svoje ime.

Push changes to GitHub

Pošaljite izmjene u repozitorijum na GitHub nalogu git push:

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

gdje umjesto <dodaj-ime-svoje-grane> stavljate ime vašeg grananja koje ste prethodno napravili.

Pošaljite izmjene na reviziju

Ukoliko odete na repozitorijum na vašem GitHub profilu primetić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 sa master granom projekta. Dobićete mejl potvrde kada se grane spoje.

Šta dalje?

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

Proslavite tako što ćete podjeliti vaš doprinos sa prijateljima i pratiocima 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 sa doprinosima drugim projektima. Napravili smo spisak projekata sa jednostavnim problemima na kojima možete početi da radite. Posetite stranicu sa the list of projects na našem sajtu.

Dodatni materijali

Uputstva za druge alate

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