Skip to content

Latest commit

 

History

History
122 lines (76 loc) · 7.15 KB

README.hu.md

File metadata and controls

122 lines (76 loc) · 7.15 KB

Open Source Love License: MIT Open Source Helpers

Első közreműködés nyilt forráskodú projektben

Minden kezdet nehéz, ezért szeretnénk segíteni számodra az első lépésekben ahhoz, hogy bátran kódolj koóperatívan nyilt forráskodú projekteket. Senki sem szeret hibázni, de szerencsére itt most nyugodtan megteheted. A lényeg, hogy gyakorolj!

A projekt célja, hogy útmutatást nyújtson, egyszerűsítse és segítse a kezdők első lépéseit nyilt forráskódú szoftverek közös programozásában. Ha te is most készülsz először ilyet csinálni, segítünk neked, kövessd az alábbi lépéseket.

forkold ezt a repot

Ha nincs a gépeden git, telepítsd fel.

Ágaztasd ezt a repot (fork)

A Fork gomb kattintásával ágaztasd el ezt a repot. Készíteni fog egy másolatot erről a reporól a te saját git fiókodba.

Klónozd a repot (clone)

klónozd ezt a repot

Most klónozd az elágaztatott repot a gépedre. Menj a GitHub fiókodra, nyisd meg a forkolt repositoryt, kattints a clone gombra, majd kattints a copy to clipboard ikonra.

Nyiss egy terminált és futtasd a következő parancsot:

git clone "url you just copied"

a "url you just copied" kifejezést, cseréld ki (idézőjelek nélkül) a vágólapra helyezett repository url címére (ami ebből a projektől ágazik). Az ágaztatás folyamatát lásd az előző lépésben.

másold az URL címet a vágólapra

Például:

git clone https://github.com/a-te-git-neved/first-contributions.git

a a-te-git-neved lesz a GitHub felhasználóneved. Ezzel letöltöd a first-contributions repositoryt GitHub-ról a saját számítógépedre.

Készíts egy ágat (branch)

Navigálj a repository könytárába (ha nem ott vagy jelenleg):

cd first-contributions

Most készítsünk egy ágat git checkout parancs használatával:

git checkout -b <add-your-new-branch-name>

Például:

git checkout -b add-gabor-takacs

(A branch nevében nem kötelező, hogy benne legyen az add szó, de ésszerű belefoglalni, mert ennek az ágnak az a célja, hogy hozzáadja a nevünket egy listához.)

Végezd el a szükséges változtatásokat és rögzítsd azokat (commit)

Nyisd meg a Contributors.md fájlt egy szövegszerkesztőben, majd add hozzá a neved. Ne a fájl elejére vagy végére helyezd, hanem a kettő közé. A kettő között bárhová teheted. Mentsd el a fájlt.

git status

Ha a project könyvtárába navigálsz és futtatod a git status parancsot, akkor a következő módosításokat fogod látni:

Ezeket a módosításokat add hozzá a branchez a git add paranccsal:

git add Contributors.md

Commitoljuk a módosításokat a git commit paranccsal:

git commit -m "Add <your-name> to Contributors list"

helyettesítsd <your-name> kifejezést a saját neveddel.

Töltsd fel az elkészült változtatásokat a GitHub-ra (push)

Töltsd fel a változtatásokat a git push paranccsal:

git push origin <add-your-branch-name>

helyettesítsd az <add-your-branch-name> kifejezést annak a branchnek a nevével, amit korábban létrehoztál.

Küldd be a módosításaidat ellenőrzésre (pull request)

Ha a saját repodba navigálsz GitHub-on, látnod kell a Compare & pull request gombot. Kattints rá!

create a pull request

Sikeresen elküldted a pull requested.

submit pull request

Kis idő elteltével összevonja a változásokat a project fő ágában. Értesítést fogsz kapni emailben, ha a változások összefűzésre kerültek.

Hogyan tovább?

Gratulálunk! Sikeresen teljesítetted az alapvető fork -> clone -> edit -> PR folyamatot, melyet gyakran kell majd csinálnod közreműködőként!

Ünnepeld meg az első kooperációdat és osszd meg barátaidall és követőiddel ennek a web app-nak a segítségével.

Bármilyen kérdésed van vagy segítségre lenne szükséged, csatlakozz slack csapatunkhoz. Csatlakozz a slack csapathoz..

Itt az idő egy másik projektben is közreműködni. Összeállítottunk egy listát azokról a projektekről, melyek könnyebb feladatokat tartalmaznak az induláshoz. Nézd meg a projektek listáját a webalkalmazásban.

Oktatóanyagok más eszközök használatával

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