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 saugyklą paspausdami šaknies simbolio mygtuką šio puslapio viršuje. Tai sukurs šios saugyklos kopiją jūsų GitHub paskyroje.
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.
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šą.)
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 komanda git push
:
git push origin <add-tavo-vardas>
pakeisdami <tavo-vardas>
anskčiau sukurtos šakos (branch) vardu.
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ą.
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.
GitHub Desktop | Visual Studio 2017 | GitKraken | Visual Studio Code | Atlassian Sourcetree | IntelliJ IDEA |