README.me.md

Prvi doprinos

Ovaj projekat ima za cilj da pojednostavi i vodi početnike do njihovog prvog doprinosa. Ako želite da napravite vaš prvi doprinos, pratite korake ispod.

Ako nijeste navikli da koristite komandnu liniju, evo tutorijala koji koristi GUI alatke.

Ako nemate git na svojoj mašini, instalirajte ga ovdje.

Napravite kopiju repozitorijuma

Napravite kopiju (fork) ovog repozitorijuma tako što ćete kliknuti na dugme fork na vrhu stranice.

Ovo će kreirati kopiju ovog repozitorijuma na vašem nalogu.

Klonirajte repozitorijum

Sada klonirajte repozitorijum na vašu mašinu. Idite na vaš GitHub profil, otvorite kopiju repozitorijuma, kliknite na dugme code i kliknite ikonicu copy to clipboard.

Otvorite terminal i unesite sledeću git komandu:

git clone "url koji ste upravo kopirali"

Umjesto "url koji ste upravo kopirali" (bez znaka navoda) unesite url repozitorijuma koji ste kopirali u prethodnom koraku.

Na primjer:

git clone https://github.com/korisnicko-ime/first-contributions.git

Umjesto korisnicko-ime napišite korisničko ime za vaš GitHub nalog. Na ovaj način kopirate sadržaj repozitorijuma na vašu mašinu.

Kreiranje grane (branch)

Prebacite se u radni direktorijum na vašem računaru (ukoliko već nijeste tu):

cd first-contributions

Sada kreirajte granu koristeći komadu git checkout:

git checkout -b ime-vase-grane

Na primjer:

git checkout -b add-nikola-popovic

(Ime grane ne mora sadržati riječ add, ali je to preporučljivo jer je poenta ove grane da se doda vaše ime na listu kontributora.)

Napravite potrebne promjene i potvrdite ih

Sada otvorite fajl Contributors.md u tekst editoru i dodajte vaše ime. Nemojte dodati svoje ime na početku ili na kraju fajla. Stavite ga bilo gdje između. Sada, sačuvajte fajl.

Ako se vratite na radni direktorijum i izvršite komandu git status, vidjećete da su prisutne promjene.

Dodajte te promjene u granu koju ste kreirali u prethodnim koracima koristeći komandu git add:

git add Contributors.md

Sada potvrdite te izmjene koristeći komandu git commit :

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

Umjesto <your-name> napišite vaše ime.

Pošaljite izmjene u repozitorijum

Pošaljite izmjene koje ste napravili u repozitorijum na GitHub-u koristeći komandu git push:

git push origin <add-ime-vase-grane>

Umjesto <add-ime-vase-grane> napišite ime grane koju ste kreirali ranije.

Pošaljite vaše izmjene na provjeru

Ako odete na repozitorijum na GitHub-u, vidjećete dugme Compare / Pull Request. Kliknite to dugme.

Sada pošaljite vaš pull request.

Uskoro, ja ću spojiti promjene koje ste napravili sa master granom repozitorijuma. Dobićete mejl potvrde kada se grane spoje.

Šta dalje?

Čestitamo! Upravo ste izvršili standradni fork -> clone -> edit -> pull request proces koji ćete često gledati dok doprinosite kodu.

Proslavite vaš doprinos i podijelite ga sa prijateljima i pratiocima kroz stranicu.

Ukoliko vam je potrebna pomoć ili imate neka pitanja, možete da se priključite našem Slack timu.

Sada možete početi da doprinosite i drugim projektima. Sastavili smo listu projekata sa jednostavim problemima na kojima možete početi da radite. Pogledajte listu projekata na stranici.

Dodatni materijali

Tutorijali koji koriste druge alatke

| | | | | | |

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