README.lv.md

Pirmais devums

Kaut ko paveikt pirmo reizi vienmēr ir grūti. Turklāt pieļaut kļūdas, jo īpaši līdzdarbojoties ar citiem, nav patīkami. Mēs vēlamies vienkāršot veidu, kā jauni atvērtā koda līdzautori mācās un pievieno savu devumu pirmo reizi.

Rakstu lasīšana un pamācību skatīšanās var palīdzēt, tomēr nekas nav labāks par īstu darbību mācību vidē. Šī projekta mērķis ir sniegt norādījumus un vienkāršot veidu, kā iesācēji pievieno savu pirmo devumu. Ja tu vēlies līdzdarboties, seko turpmāk norādītajiem soļiem.

Ja tu nejūties ērti ar komandrindu, izmanto GUI rīku pamācības.

Ja tavā datorā nav git, uzinstalē to.

Izveido repozitorija atzarojumu

Izveido savu repozitorija atzarojumu, nospiežot fork pogu šīs lapas augšpusē. Tādējādi tavā profilā tiks izveidota šī repozitorija kopija.

Klonē repozitoriju

Tagad klonē nokopēto repozitoriju savā datorā. Ej uz savu GitHub profilu, atver nokopēto repozitoriju, nospied clone pogu un tad nospied uz copy to clipboard ikonas.

Atver termināli un palaid šo git komandu:

git clone "tikko nokopētā saite"

kur "tikko nokopētā saite" (bez pēdiņām) ir url uz šo repozitoriju (tavs projekta atzarojums). Apskaties iepriekšējos soļos, kā dabūt url.

Piemēram:

git clone https://github.com/tavs-vārds/first-contributions.git

kur tavs-vārds ir tavs GitHub lietotājvārds. Šādi tu kopē GitHub repozitorija first-contributions saturu savā datorā.

Izveido zaru

Savā datorā nomaini repozitorija direktoriju (ja tu vēl neatrodies tajā):

cd first-contributions

Tagad izveido zaru ar git checkout komandu:

git checkout -b <ieliec-jaunā-zara-nosaukumu>

Piemēram:

git checkout -b add-alonzo-church

(Zara nosaukumā nav obligāti jābūt vārdam add, bet būtu lietderīgi to iekļaut, jo šī zara mērķis ir tava vārda pievienošana sarakstam.)

Veic nepieciešamās izmaiņas un iesūti tās

Tagad atver Contributors.md failu teksta redaktorā un pievieno tam savu vārdu. Nepievieno to faila sākumā vai beigās, bet ievieto to kaut kur pa vidu. Pēc tam saglabā failu.

Ja tu dosies uz projekta direktoriju un izpildīsi komandu git status, tu redzēsi, ka tajā ir izmaiņas.

Pievieno šīs izmaiņas zaram, kuru tu tikko izveidoji, ar git add komandu:

git add Contributors.md

Tagad iesūti šīs izmaiņas ar git commit komandu:

git commit -m "Add <tavs-vārds> to Contributors list"

aizvietojot <tavs-vārds> ar savu vārdu.

Pievieno izmaiņas GitHub

Pievieno savas izmaiņas ar komandu git push:

git push origin <ievieto-zara-nosaukumu>

aizvietojot <ievieto-zara-nosaukumu> ar zara, kuru tu iepriekš izveidoji, nosaukumu.

Iesniedz izmaiņas pārskatīšanai

Ja tu dosies uz savu GitHub repozitoriju, tu redzēsi Compare & pull request pogu. Nospied to.

Tagad iesniedz pievienotās izmaiņas.

Jau pavisam drīz es pievienošu visas tavas izmaiņas šī projekta galvenajam (master) zaram. Tu saņemsi paziņojumu e-pastā, tiklīdz izmaiņas būs pievienotas.

Un ko tagad?

Apsveicam! Tu tikko pabeidzi standarta fork -> clone -> edit -> PR darbplūsmu, ar kuru turpmāk bieži nāksies sastapties kā līdzautoram.

Pastāsti par savu devumu saviem draugiem un sekotājiem, izmantojot mūsu vietni.

Tu vari pievienoties arī mūsu slack komandai, ja tev nepieciešama palīdzība vai ir kādi jautājumi. Pievienojies slack.

Tagad tu vari līdzdarboties arī citos projektos. Mēs esam sastādījuši sarakstu ar projektiem, kuros ir vienkāršas problēmas, ar kurām tu varētu sākt. Izpēti projektu sarakstu mūsu vietnē.

Papildu materiāli

Pamācības citiem rīkiem

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