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.
Forkajte ovaj repozitorij tako da kliknete na dugme fork na vrhu stranice. Ovako pravite kopiju repozitorija na vašoj github stranici.
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.
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
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.
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.
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.
Č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.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |