Skip to content

Latest commit

 

History

History
124 lines (76 loc) · 7.49 KB

README.hu.md

File metadata and controls

124 lines (76 loc) · 7.49 KB

Open Source Love License: MIT Open Source Helpers

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.

forkold ezt a repót

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)

klónozd ezt a repót

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.

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 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.

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 <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á!

pull request készítése

Sikeresen elküldted a pull requested.

pull request beküldése

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.

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

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