README.lt.md

Pirmieji įnašai

Sunku. Visada sunku ką nors padaryti pirmą kartą. Ypač bendradarbiaujant, klaidų darymas nėra malonus dalykas. Tačiau atviras kodas - tai bendravimas ir bendradarbiavimas. Mes norime paprasčiau paaiškinti naujiesiems atvirojo kodo kūrėjams, kaip jie gali prisidėti pirmą kartą.

Galite pradėti skaityti straipsnius ir žiūrėti vadovus, bet kas gali būti geriau nei mokymasis darant be klaidų pirmą kartą? Šio projekto tikslas - suteikti patarimus ir supaprastinti tai, kaip naujokai daro pirmąjį indėlį. Prisiminkite: kuo labiau esate atsipalaidavęs, tuo geriau mokotės. Jei norite atlikti pirmąjį indėlį, atlikite toliau pateiktus paprastus veiksmus. Mes pažadame, tai bus smagu.

Jei neturite instaliuoto git, instaliuokite čia .

Kopijuokite (fork) šią saugyklą

Kopijuokite saugyklą paspausdami šaknies simbolio mygtuką šio puslapio viršuje. Tai sukurs šios saugyklos kopiją jūsų GitHub paskyroje.

Klonuokite saugyklą

Dabar klonuokite šią saugyklą į savo kompiuterį. Spustelėkite klonavimo mygtuką ir tada spustelėkite copy to clipboard piktogramą.

Atidarykite terminalą ir paleiskite šią git komandą:

git clone "kopijuota nuoroda"

kur "kopijuota nuoroda" (be citatos ženklų) yra url nuoroda jūsų saugyklai. Peržiūrėkite ankstesnius veiksmus, kad gautumėte url nuorodą.

Pavyzdžiui:

git clone https://github.com/tai-jus/first-contributions.git

kur tai-jus yra jūsų GitHub paskyros vartotojo vardas. Čia jūs kopijuojate first-contributions saugyklos turinį į "GitHub" aplanką savo kompiuteryje.

Sukurkite šaką (branch)

Pakeiskite kompiuterio saugyklos katalogą (jei dar to nepadarėte anksčiau):

cd first-contributions

Dabar sukurkite šaką naudodami komandą git checkout:

git checkout -b <add-tavo-vardas>

Pavyzdžiui:

git checkout -b add-vardenis-pavardenis

(Saugyklos pavadinime neturi būti žodžio add, bet tai yra reikalinga, kadangi šios šakos (branch) paskirtis yra įtraukti savo vardą į sąrašą.)

Atlikite reikiamus pakeitimus ir pridėkite (commit) šiuos pakeitimus

Dabar atidarykite failą Contributors.md teksto redaktoriuje, pridėkite prie jo savo vardą ir išsaugokite failą. Jei eisite į projekto katalogą ir paleisite komandą git status, pamatysite, kad yra pakeitimų. Pridėkite šiuos pakeitimus į ką tik sukurtą šaką (branch) komandos git add pagalba:

git add Contributors.md

Dabar atlikite šiuos pakeitimus naudodami komandą git commit:

git commit -m "Add <tavo-vardas> to Contributors list"

pakeisdami <tavo-vardas> savo vardu.

Išsiųskite pakeitimus į GitHub

Išsiųskite pakeitimus komanda git push:

git push origin <add-tavo-vardas>

pakeisdami <tavo-vardas> anskčiau sukurtos šakos (branch) vardu.

Pateikite pakeitimus peržiūrai

Eikite į savo saugyklą GitHub. Pamatysite mygtuką Compare & pull request (palyginti ir įtraukti užklausą). Spustelėkite šį mygtuką.

Dabar pateikite įtraukimo į pradinę saugyklą (pull) užklausą.

Netrukus projekto autorius sujungs visus jūsų šakos pakeitimus su šio projekto pagrindine šaka. Kai pakeitimai bus sujungti, gausite tai patvirtinantį el. laišką.

Kas toliau?

Džiaukitės ir atkreipkite dėmesį į savo įnašą pasidalindami šia žinia su draugais interneto aplikacijoje.

Prisijunkite prie mūsų "slack" komandos, jei jums reikia pagalbos ar turite klausimų. Prisijungti prie slack.

Pradėkite tobulinti kitus projektus. Mes sukūrėme projektų sąrašą, kuriuose yra lengvai išsprendžiamų problemų. Peržiūrėkite projektų sąrašą interneto aplikacijoje.

Papildoma medžiaga

Pamokos naudojant kitus įrankius

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