Skip to content

Latest commit

 

History

History
123 lines (76 loc) · 7.06 KB

File metadata and controls

123 lines (76 loc) · 7.06 KB

Open Source Love License: MIT Open Source Helpers

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.

fork this repository

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

clone this repository

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.

copy URL to clipboard

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.

git status

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.

create a pull request

Tagad iesniedz pievienotās izmaiņas.

submit pull request

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ē.

Pamācības citiem rīkiem

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