Prvi doprinosi

Cilj ovog projekta je da pruži jednostavne korake za početnike da naprave svoje prve doprinose. Ukoliko tražite da napravite prvi doprinos pratite sljedeće korake ispod.

Ukoliko niste baš sigurni u vaš rad sa naredbnom linijom/terminalom, ovdje možete pronaći tutorijale za GUI alate.

Ukoliko nemate git instaliran na vašom računalu, instalirajte ga ovdje.

Napravite fork repozitorija

Forkajte ovaj repozitorij tako da kliknete na dugme fork na vrhu stranice. Ovako pravite kopiju repozitorija na vašoj github stranici.

Klonirajte repozitorij

Sada klonirajte repozitorij koji ste prethodno forkali. Posjetite svoj GitHub profil, otvorite repozitorij koji ste forkali, kliknite na clone (kloniraj) dugme i kliknite na ikonicu copy to clipboard.

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

git clone "url koji ste sada kopirali"

gdje je "url koji ste sada kopirali" (bez navodnika) url na ovaj repozitorij (vaš fork ovog projekta). Pogledajte prethodne korake kako dohvatiti url.

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. Ovime kopirate sadržaj repozitorija first-contributions na vaše računalo.

Pravljenje grane branch

Prebacite se u radni direktorij na vašem računalu (ukoliko već niste tamo):

cd first-contributions

Pa zatim napravite novu granu branch koristeći git switch comandu:

git switch -c add-svoje-ime

Na primjer:

git switch -c add-alonzo-church

Napravite potrebne izmjene i potvrdite promjene

Otvorite Contributors.md datoteku 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 datoteku.

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

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

git add Contributors.md

Sada potvrdite ove promjene koristeći git commit naredbu:

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

Gdje umjesto tvoje-ime upisujete svoje ime.

Pushajte promjene na GitHub

Pošaljite promjene u repozitorij na GitHub-u koristeći naredbu git push:

git push origin -u ime-vaše-grane

gdje umjesto ime-vaše-grane stavljate ime vaše grane koje ste prethodno napravili.

Pošaljite izmjene na pregled

Ukoliko odete na repozitorij na vašem GitHub profilu primijetit ćete Compare & pull request Dugme. Kliknite na njega.

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

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

Što 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 popis projekata sa jednostavnim problemima na kojima možete početi raditi. Posjetite listu projekata na naštoj stranici.