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.
Ukoliko nemati git instaliran na vašoj mašini, instalirajte ga ovde.
Napravite račvanje (fork) tako što ćete kliknuti na dugme fork na vrhu stranice. Ovako pravite kopiju repozitorijuma na vašoj strani.
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.
Prebacite se u radni direktorijum 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.
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.
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.
Ukoliko odete na repozitorijum 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.
Č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.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |