README.slk.md

Prvé príspevky

Je to ťažké. Je to vždy ťažké, keď niečo robíš prvýkrát. Najmä vtedy, keď spolupracuješ, robiť chyby nie je pohodlná vec. Chceli sme zjednodušiť spôsob, akým sa noví prispievatelia do open source učia a prispievajú prvýkrát.

Čítanie článkov a sledovanie tutoriálov môže pomôcť, ale čo je lepšie, ako skutočne robiť veci v skúšobnom prostredí? Cieľom tohto projektu je poskytnúť usmernenie a zjednodušiť spôsob, akým prvýkrát prispievajú začiatočníci. Ak máš záujem o prvý príspevok, postupuj podľa nižšie uvedených krokov.

Ak sa ti nedarí s príkazovým riadkom, tu sú návody s nástrojmi grafického rozhrania.

Ak nemáš na svojom počítači git, nainštaluj ho.

Skopíruj toto úložisko

Skopíruj toto úložisko kliknutím na tlačidlo vidlice(fork) v hornej časti tejto stránky. Tým sa vytvorí kópia tohto úložiska na tvojom účte.

Stiahni toto úložisko

Teraz stiahni toto úložisko do tvojho zariadenia. Prejdi do tvojho účtu GitHub, otvor skopírované úložisko, klikni na tlačidlo klonovania a potom klikni na ikonu * kopírovať do schránky *.

Otvor terminál a spusti nasledujúci git príkaz:

git clone "adresa, ktorú si práve skopíroval"

kde "adresa ktorú si práve skopíroval" (bez úvodzoviek) je adresa URL tohto úložiska (tvoja kópia tohto projektu). Pozri si predchádzajúce kroky na získanie adresy URL.

Napríklad:

git clone https://github.com/toto-si-ty/prve-prispevky.git

kde toto-si-ty je tvoje GitHub užívateľské meno. Tu skopíruješ obsah GitHub úložiska prve-prispevky do tvojho počítača.

Vytvor vetvu

Prejdi do adresára úložiska v tvojom počítači (ak ešte nie si tam):

cd prve-prispevky

Teraz vytvor vetvu pomocou príkazu git checkout:

git checkout -b <pridaj-meno-tvojej-novej-vetvy>

Napríklad:

git checkout -b pridaj-ferko-mrkvicka

(Názov pobočky nemusí obsahovať slovo * pridaj *, ale je rozumné pridať ho, pretože účelom tejto pobočky je pridať tvoje meno do zoznamu.)

Vykonaj potrebné zmeny a potvrď tieto zmeny

Teraz otvor súbor Contributors.md v textovom editore a pridaj do neho svoje meno. Nepridávaj ho na začiatok alebo na koniec súboru. Daj ho kdekoľvek medzi tým. Teraz súbor ulož.

Ak prejdeš do adresára projektu a vykonáš príkaz git status, uvidíš zmeny.

Pridaj tieto zmeny do vetvy, ktorú si práve vytvoril, pomocou príkazu git add:

git add Contributors.md

Teraz vykonaj tieto zmeny pomocou príkazu git commit:

git commit -m "Pridaj <tvoje-meno> do zoznamu pripievateľov"

nahraď <tvoje-meno> tvojim menon.

Nahraj zmeny na GitHub

Nahraj svoje zmeny pomocou príkazu git push:

git push origin <pridaj-meno-tvojej-novej-vetvy>

nahraď <pridaj-meno-tvojej-novej-vetvy> názvom vetvy, ktorú si vytvoril skôr.

Odošli svoje zmeny na kontrolu

Ak prejdeš do tvojho úložiska v službe GitHub, zobrazí sa tlačidlo Compare & pull request. Klikni na toto tlačidlo.

Teraz predlož požiadavku na vytiahnutie.

Čoskoro budem zlučovat všetky vaše zmeny do hlavnej pobočky tohto projektu. Po zlúčení zmien dostaneš upozornenie.

Kam ísť odtiaľto?

Gratulujem! Práve si dokončil štandardný fork -> klon -> upraviť -> PR pracovný postup, ktorý sa často stretneš ako prispievateľ!

Osláv svoj príspevok a zdieľaj ho so svojimi priateľmi a nasledníkmi web app.

Môžeš sa pripojiť k nášmu slack tímu v prípade, že potrebuješ nejakú pomoc alebo máš nejaké otázky. Join slack team.

Teraz začni s účasťou na iných projektoch. Vytvorili sme zoznam projektov s jednoduchými problémami, s ktorými môžeš začať. Pozri zoznam projektov vo webovej aplikácii.

Dodatočný materiál

Návody pomocou iných nástrojov

GitHub Desktop	Visual Studio 2017	GitKraken	Visual Studio Code