Skip to content

Latest commit

 

History

History
125 lines (73 loc) · 6.94 KB

README.sk.md

File metadata and controls

125 lines (73 loc) · 6.94 KB

Open Source Love License: MIT Open Source Helpers

Prvý príspevok

Život je ťažký. Obzvlášť keď niečo robíte prvýkrát. V prípade, že na niečom spolupracujete, nie je robenie chýb niečo, čo by vám robilo radosť. My by sme radi zjednodušili cestu novým prispievateľom do open-source pri ich učení sa ako na to.

Čítanie článkov alebo zhliadnutie video návodov sú tiež cesty, ale čo je lepšie ako si danú vec priamo ohmatať na vlastnej koži v reálnom prostredí? Tento projekt je zameraný na poskytnutie pomoci začiatočníkom s ich prvým prispením do open-source. Ak ste ním práve vy, nasledujte kroky popísané nižšie.

forknite tento repozitár

Ak máte nainštalovaný git, nainštalujte si ho.

Forknite tento repozitár

Forknite (vytvorenie kópie z originálu, z anglického fork - vidlička, ako vytvorenie novej odnože) tento repozitár kliknutím na tlačidlo Fork hore na tejto stránke. Tým vytvoríte kópiu tohto repozitára na svojom vlastnom GitHib účte.

Naklonujte repozitár

naklonujte tento repozitár

Teraz naklonujte (anglicky clone) forknutý repozitár na váš počítač, naklonovanie nie je nič iné ako stiahnutie obrazu repozitára k vám na počítač. Na vašom GitHub účte si otvoríte forknutý repozitár, kliknite na tlačidlo Clone or download a následne v okienku, ktoré sa objaví, kliknite na tlačidlo s ikonkou copy to clipboard vedľa URL adresy, čím si ju skopírujete do schránky.

Teraz otvorte terminál a spustite nasledujúci príkaz:

git clone "url ktoré ste práve skopírovali"

skopírujte adresu do schránky

Napríklad:

git clone https://github.com/vas-username/first-contributions.git

Týmto na svojom počítači vytvoríte priečinok so súbormi daného repozitára.

Vytvorte vetvu

V príkazovom riadku sa prepnite do zložky s repozitárom (ak v nej už nie ste)

cd first-contributions

Teraz vytvorte novú vetvu (anglicky branch) za použitia príkazu git checkout:

git checkout -b <meno-novej-vetvy>

Napríklad:

git checkout -b pridanie-mojho-mena

Meno vetvy by malo vypovedať o tom, čo kód alebo čokoľvek iné do nej pridané bude robiť/vykonávať, prípadne prečo sa daná vec deje.

Urobte zmeny a zaznamenajte ich

Otvorte súbor Contributors.md v textovom editore a pridajte do neho svoje meno. Napíšte ho niekam doprostred a súbor uložte.

<img align="right" width="450" ​​src="https://firstcontributions.github.io/assets/Readme//git-status.png" alt="git status" />

Pokiaľ teraz v príkazovom riadku spustíte príkaz git status, uvidíte aké zmeny boli v repozitári vykonané.

Tieto zmeny do danej vetvy pridáte príkazom git add:

git add Contributors.md

Zostáva už len potvrdiť (anglicky commit) zmeny príkazom git commit:

git commit -m "Add <vase-meno> to Contributors list"

Za prepínač -m sa píše čo dané zmeny predstavujú, popis by mal byť jednoduchý ale výstižný.

Pretlačte zmeny na GitHub

Teraz zmeny vykonané lokálne na počítači pretlačíme (anglicky push) na GitHub príkazom git push:

git push origin <meno-vasej-vetvy>

Predložte svoje zmeny na posúdenie

Pokiaľ sa teraz pozriete do svojho GitHub repozitára, uvidíte tlačidlo Compare & pull request. Kliknite naň.

vytvorte pull request

Teraz vytvorte žiadosť o pretiahnutie vašej vetvy do originálneho repozitára (anglicky pull request).

potvrďte pull request

Čoskoro budú správcovia vykonávať zapracovanie vašich zmien do hlavnej (anglicky master) vetvy tohto projektu. Až sa do nej vaše zmeny dostanú, dostanete emailové upozornenie.

Kam ďalej?

Blahoželáme! Práve ste dokončili štandardný fork -> clone -> edit -> priebeh práce (anglicky *workflow), s ktorým sa ako prispievateľ do projektov stretnete dennodenne.

Oslávte svoj prvý príspevok so svojimi priateľmi a nasledovníkmi cez webovú aplikáciu.

V prípade, ak by ste mali akékoľvek otázky alebo potrebovali pomoc, môžete sa pridat k našemu Slack teamu.

Teraz vám už nič nebráni v prispievaní do ostatných projektov. Pripravili sme pre vás zoznam projektov, ktoré majú jednoduché záležitosti na vyriešenie/naprogramovanie, s ktorými môžete začať. Pozrite sa tu.

Návod za použitia ďalších nástrojov

GitHub Desktop Visual Studio 2017 GitKraken VS Code
GitHub Desktop Visual Studio 2017 GitKraken Visual Studio Code