README.sr.md

Prvi prilog

Teško je. Prvi pokušaj je uvek težak. Kada sarađuješ sa drugima, napraviti greške je utoliko strašnije. Želeli bismo da olakšamo proces kroz koji novi programeri koji doprinose otvorenom softveru (eng. open source) uče i doprinose po prvi put.

Iako blogovi i tutorijali mogu da pomognu, ništa nije bolje nego uzeti stvari u svoje ruke i zaista doprinositi u trening-sredini. 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, pratite sledeće korake.

Ako vam je nezgodno da čitate tekst u komandnoj liniji, evo linka kroz GUI alate.

Možete čitati tekst i na drugim jezicima.

🇮🇳 🇲🇲 🇮🇩 🇫🇷 🇪🇸 🇳🇱 🇱🇹 🇷🇺 🇧🇬 🇸🇰 🇯🇵 🇻🇳 🇵🇱 🇮🇷 🇮🇷 🇰🇷 🇰🇵 🇩🇪 🇩🇰 🇨🇳 🇹🇼 🇬🇷 🇪🇬 🇸🇦 🇺🇦 🇧🇷 🇵🇹 🇮🇹 🇹🇭 🏴 🇳🇵 🇵🇰 🇧🇩 🇲🇩 🇷🇴 🇹🇷 🇸🇪 🇲🇾 🇸🇮 🇮🇱 🇨🇿 🇲🇽 🇵🇭 🇿🇦 🇿🇦 🇰🇪 🇳🇬 🇱🇻 🇷🇸

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

Napravite fork repozitorijuma

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

Klonirajte repozitorijum

Sledeće, klonirajte repozitorijum koji ste prethodno račvali. Posetite svoj GitHub profil, otvorite repozitorijum koji ste račvali, kliknite na clone dugme i kliknite na ikonicu copy to clipboard.

Otvorite terminal i upišite sledeće git komande:

git clone "url you just copied"

Umesto "url you just copied" (bez navodnika i razmaka) upišite url repozitorijuma koji ste kopirali u prethodnom koraku.

Na primer:

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

Gde je umesto this-is-you upisano vaše korisničko ime. Ovim kopirate sadržaj repozitorijuma first-contributions na vašu mašinu.

Pravljenje grane branch

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

cd first-contributions

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

git checkout -b <add-your-new-branch-name>

Na primer:

git checkout -b add-alonzo-church

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

Napravite potrebne izmene i potvrdite promene

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

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

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

git add Contributors.md

Sada potvrdite ove promene koristeći git commit komandu:

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

Gde umesto <your-name> upisujete svoje ime.

Push changes to GitHub

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

git push origin <add-your-branch-name>

gde umesto <add-your-branch-name> stavljate ime vašeg grananja.

Pošaljite izmene na reviziju

Ukoliko odete na repoyitorijum na vašem GitHub nalogu primetićete Compare & pull request Dugme. Kliknite na njega.

a potom pošaljite zahtev klikom na dugme submit.

Nakon toga, ja ću spojiti promene 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 podeliti 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