README.hu.md

Első közreműködés nyílt 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 kooperatívan nyílt 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 nyílt 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övesd az alábbi lépéseket.

Ha a parancssor kényelmetlen, itt egy tutorial a GUI felület használatához.

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

Ágaztasd ezt a repót (fork)

A Fork gomb kattintásával ágaztasd el ezt a repót. Ezzel készítettél egy másolatot erről a reporól a te saját git fiókodba.

Klónozd a repót (clone)

Most klónozd az elágaztatott repót 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-amit-most-masoltal-le"

A "url-amit-most-masoltal-le" 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.

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 switch -c <az-uj-branch-neve>

Például:

git switch -c add-gabor-takacs

(A branch nevében nem kötelező, hogy benne legyen az add szó, de észszerű 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.

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 <a-te-neved> to Contributors list"

Helyettesítsd <a-te-neved> 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 <a-branch-neve>

Helyettesítsd az <a-branch-neve> 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 repódba navigálsz GitHub-on, látnod kell a Compare & pull request gombot. Kattints rá!

Sikeresen elküldted a pull requested.

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 oszd meg barátaiddal é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.

Kiegészítő anyag

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

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