Miért vegyél részt a Nyílt Forráskódú fejlesztésben?

A nyílt forráskódhoz való hozzájárulás a tanulás, a tanítás és a tapasztalatok megszerzésének a legjobb útja bármiben, amit csak el tudsz képzelni.

Miért járulnak hozzá az emberek a nyílt forráskódhoz? Rengeteg oka van!

Készségfejlesztés

Kódolás, felhasználói felület tervezése, grafikai tervezés, írás vagy akár szervezés – ha gyakorlatot keresel, akkor találsz feladatot nyílt forráskódú projekten.

Találkozz hasonló érdeklődésű emberekkel

A nyílt forráskódú projektek befogadó, barátságos közösségek, ahová évek múlva is visszatérnek az emberek. Sokan egy egész életen át tartó barátságot kötnek a nyílt forráskódú részvételük révén, függetlenül attól, hogy konferenciákon vagy késő esti online beszélgetéseken ismerkednek-e meg.

Keress mentorokat és taníts másokat

Közös projekten dolgozni másokkal azt jelenti, hogy el kell magyaráznod, hogy hogyan működnek a dolgok, vagy más embereket kell megkérned, hogy segítsenek. A tanításban és tanulásban minden résztvevő ki tud teljesedni.

Növeld a hírnevedet és támogasd a karriered azzal, hogy közzéteszed a munkád

Alapértelmezés szerint minden nyílt forráskódú munka publikus, amit azt jelenti, hogy bárhol megjelenhetsz a munkáiddal bemutatva azt, hogy mire vagy képes.

Emberi készségek fejlesztése

A nyílt forráskód számos kihívást tartogat a vezetői és szervezői készségek gyakorlásában, úgy mint konfliktus megoldás, csapatszervezés és a feladatok priorizálása.

Lehetőséged van változtatni, még ha kicsit is

Ahhoz, hogy sikerélményed legyen egy nyílt forráskódú projektben, nem kell egy életen át részt venned a munkában. Láttál már valaha egy elgépelést egy weboldalon, és kívántad már azt, hogy valaki bárcsak kijavítaná? Egy nyílt forráskódú projektben éppen ezt tudod megtenni. A nyílt forráskód segít abban, hogy az emberek a saját életüket irányítsák és azt, hogy hogyan alakítsák a világot a maguk örömére.

Mit jelent a hozzájárulás?

Ha új vagy a nyílt forráskódban, akkor a folyamat először félelmetes lehet. Hogyan találd meg a jó projektet? Mi van, ha nem jól kódolsz? Mi történik, ha valami nem működik?

Ne aggódj! Rengeteg módja van annak, hogy részt vegyél a nyílt forráskódú fejlesztésekben, és számos tipp segít abban, hogy a legtöbbet hozd ki magadból.

Nem kell kóddal hozzájárulnod

Gyakori tévhit a nyílt forráskódhoz való hozzájárulásról, hogy programozni kell hozzá. Valójában gyakran a projekt többi része az, amely elhanyagolt, vagy mellőzött. Óriási segítség a projektnek, ha ilyen jellegű munkával járulsz hozzá!

Még ha szeretsz is programozni, akkor is nagyszerű módja a projektben való részvételnek vagy hogy találkozz közösségi tagokkal az, hogy más jellegű hozzájárulásod van a projekthez. Ezeknek a kapcsolatoknak a kiépítése lehetőséget teremt arra, hogy a projekt egyéb részein dolgozz.

Szeretsz rendezvényt szervezni?

  • Szervezz gyakorlati előadásokat vagy találkozókat a projektről, ahogy @fzamperin csinálja a NodeSchool-nál
  • Szervezd meg a projekttel kapcsolatos konferenciát (ha van ilyen)
  • Segíts a közösség tagjainak megtalálni a megfelelő rendezvényeket és írj javaslatokat az előadások témáira

Szereted a grafikai tervezést?

  • Alakítsd át a megjelenést, hogy a projekt jobban áttekinthető legyen
  • Végezz felhasználói igényfelmérést, hogy javítsd vagy finomítsd a projekt oldal navigációját vagy menürendszerét, például ahogy a Drupal javasolja
  • Állíts össze egy stílus útmutatót ezzel segítve az egységes vizuális megjelenést
  • Készíts póló terveket vagy új logót, ahogy a hapi.js fejlesztői tették

Szeretsz írni?

  • Írd és javítsd a projekt dokumentációját
  • Tarts karban egy példa könyvtárat a projekt használatáról
  • Indíts hírlevelet a projektről, vagy a levelező listáról készít összefoglalót
  • Írj útmutatókat a projektről, ahogy PyPA fejlesztői tették
  • Fordíts le a projekt dokumentációját

Szeretsz szervezni?

  • Kapcsold össze a duplikált hibajegyeket és javasolj más címkéket, hogy jobban szervezett legyen a projekt
  • Nézd át a nyitott hibajegyeket és javasold a régiek lezárását, ahogy @nzakas csinálta az ESLint esetén
  • Tegyél fel tisztázandó kérdéseket a közelmúltban megnyitott felvetésekről, problémákról a vita előmozdítása érdekében

Szeretsz kódolni?

  • Keress nyitott problémákat, amelyeket megoldhatsz, mint ahogy @dianjin csinálta a Leaflet esetén
  • Kérdezd meg, hogy tudsz-e segíteni valamely új funkció kifejlesztésében
  • Automatizáld a projektet
  • Fejleszd az eszközöket és a teszteket

Szeretsz segíteni embereken?

  • Válaszolj a projekttel kapcsolatos kérdésekre, például a StackOverflow-n, (mint ez a Postgres példa) vagy a Reddit-en
  • Válaszold meg a kérdéseket a nyitott problémákról
  • Segíts moderálni a beszélgetést a fórumokon vagy egyéb csatornákon

Szeretsz másoknak segíteni a kódolásban?

Nem csak szoftver projekten tudsz dolgozni!

Bár a “nyílt forráskód” gyakran szoftverre utal, bármi másban is részt tudsz venni. Vannak könyvek, receptek, válogatott listák és útmutatók, amelyeket nyílt forráskódú projektként fejlesztenek.

Például:

Még ha szoftverfejlesztő is vagy, egy dokumentációs projekt könnyebbé teszi az elindulást a nyílt forráskód világában. Kevésbé ijesztő, ha olyan projektben veszel részt először, ami nem tartalmaz kódot és a másokkal való együttműködés folyamán alakul ki az önbizalmad és nő a tapasztalatod.

Kezdetek egy új projektben

Bármi más dolog, mint mondjuk egy elírás javítása olyan, mintha idegenekkel állnál le beszélgetni. Ha elkezdesz a lámákról beszélni, miközben ők elmélyedt párbeszédet folytatnak az aranyhalakról, akkor lehet kicsit furán fognak rád nézni.

Mielőtt vakon javasolnál valamit, próbálj elmélyedni a témában, hogy megértsd azt. Ha így teszel, nagyobb eséllyel figyelnek oda a véleményedre és javaslataidra.

Egy nyílt forráskódú projekt anatómiája

Minden nyílt forráskódú közösség más.

Éveket eltölteni ugyanazzal a nyílt forráskódú projekttel azt jelenti, hogy ismersz egy nyílt forráskódú projektet. Egy másik projekt esetén teljesen más fogalmakkal, viselkedési normákkal és kommunikációs módszerekkel találkozhatsz.

Ugyanakkor számos nyílt forráskódú projekt hasonló módon működik. Az eltérő közösségi szerepek vagy folyamatok megértése segít abban, hogy gyorsan alkalmazkodni tudj bármely új projekthez.

Egy tipikus nyílt forráskódú projekt esetén az alábbi szerepek vannak:

  • Szerző: Személy(ek), esetleg szervezet, aki létrehozta a projektet
  • Tulajdonos: Személy(ek), akinek adminisztrációs joga van a szervezet vagy a nyílt forrás felett (nem mindig egyezik a Szerzővel a személye)
  • Karbantartók: Olyan résztvevők, akiknek felelőssége a projekt irányítása, az elképzelések formába öntése. (Ők lehetnek akár a Szerzői vagy a Tulajdonosai is a projektnek.)
  • Közreműködők: Bárki, aki hozzájárul valamivel a projekthez.
  • Közösség tagjai: Emberek, akik használják a projektet. Aktívak lehetnek a vitákban, vagy jelezhetik észrevételeiket a projekttel kapcsolatban.

A nagyobb projekteknek lehetnek olyan albizottságai vagy munkacsoportjai is, amelyek különböző feladatokra összpontosítanak, mint például eszközök, prioritás, közösségi moderálás és rendezvényszervezés. Ezt az információt megtalálod a projekt honlapján a “csapat” oldalon, vagy a működési szabályok dokumentációi között.

A projektnek dokumentációja is van. Ezek a fájlok általában a forráskód legfelső szintjén vannak felsorolva.

  • LICENSE: Alapértelmezés szerint minden nyílt forráskódú projektnek kell rendelkeznie egy nyílt forráskód licenccel. Ha a projektnek nincs ilyen licence, akkor az nem nyílt forráskód.
  • README: A README egy használati útmutató a közösség új tagjainak. Elmagyarázza, hogy miért hasznos a projekt és hogy hogyan lehet használni.
  • CONTRIBUTING: Míg a README segíti az embereket a használatban, addig a CONTRIBUTING a projektben való részvétel módját dokumentálja. Elmagyarázza, hogy mivel járulhatsz hozzá a projekthez és hogyan működnek a folyamatok. Bár nem minden projektnek van ilyen dokumentációja, a jelenléte azt mutatja, hogy számítanak a részvételedre és a hozzájárulásodra.
  • CODE_OF_CONDUCT: Magatartási kódex, amely meghatározza a résztvevők magatartásának alapszabályait és elősegíti a barátságos környezet kialakítását. Bár nem minden projektnek van ilyen dokumentációja, a jelenléte azt mutatja, hogy barátságos projekt, amely számít a részvételedre.
  • Egyéb dokumentációk: Lehetnek további dokumentációk, különösen nagyobb projektek esetén, mint például oktató anyagok, fejlesztési útmutatók, irányítási szabályok.

A nyílt forráskódú projektek az alábbi eszközöket használják az egyeztetések szervezéséhez. A korábbi anyagok elolvasása jó képet ad arról, hogyan gondolkodik és működik a közösség.

  • Issue tracker: A résztvevők ennek segítségével beszélik meg a projekttel kapcsolatos problémákat.
  • Pull requests: A résztvevők ezek segítségével vitatják meg és tekintik át a folyamatban lévő változtatásokat.
  • Internetes fórumok vagy levelező listák: Néhány projekt használhatja ezen csatornákat is a különböző témák átbeszélésére (például, “Hogyan tudom…?” vagy “Mit gondolsz arról, hogy…?” című témát indít a hiba jelentés, vagy új funkció létrehozása helyett). Mások minden beszélgetést az Issue tracker-en keresztül kezelnek.
  • Csevegő csatorna: Néhány projekt azonnali üzenetküldő (IM) csevegő csatornákat használ (mint amilyen a Slack vagy az IRC) általános beszélgetésre, együttműködésre és gyors üzenet váltásra.

Találd meg a projektedet!

Most, hogy már tudod, hogy hogyan működnek a nyílt forráskódú projektek, itt az idő megtalálni azt, amelyben részt veszel!

Ha még sohasem vettél részt nyílt forráskódú fejlesztésben korábban, akkor fogadd meg John F. Kennedy volt amerikai elnök egyik tanácsát: “Ne azt kérdezd, hogy az ország mit tud tenni érted – kérdezd azt, hogy te mit tehetsz az országért.”

Hozzájárulás egy nyílt forráskódú projekthez bárhogy lehetséges, bármelyik projektben. Nem kell túlgondolni azt, hogy pontosan mi lesz az első hozzájárulásod, vagy azt, hogy az hogyan fog kinézni.

Gondolkozz olyan projektben, amelyet már használsz, vagy használni akarsz. Azokat a projekteket, amelyekben aktívan részt veszel, szívesebben használni fogod a jövőben is.

Ezekben a projektekben, amikor azon kapod magad, hogy gondolkozol egy jobb vagy más megoldásban, cselekedj ösztönösen!

A nyílt forráskód nem egy zártkörű klub; ugyanolyan emberek dolgoznak rajta, mint te. A “Nyílt Forráskód” csak egy divatos kifejezés arra, hogy a világ problémáit megoldhatóként is lehet kezelni.

Talán épp a README-t olvasod és találsz egy rossz hivatkozást, vagy egy elírást. De az is lehet, hogy új felhasználó vagy és észreveszel valami hibát, vagy egy problémát, amit dokumentálni kellene. Ahelyett, hogy nem törődsz vele és továbblépsz vagy megkérsz valakit, hogy javítsa, inkább ajánld fel a segítséged. Ez az amiről a nyílt forráskód szól!

a nyílt forráskódú alkalmi hozzájárulások 28%-a a dokumentációt érinti, mint például egy elírás javítása, formázás, vagy fordítás.

Ha szeretnél egy hibát javítani, akkor minden nyílt forráskódú projekt esetén találsz egy /contribute oldalt, amely segít abban, hogy kezdőként kijavítsd az első hibát. A projekt GitHub kezdőoldal URL-jét egészítsd ki a /contribute résszel a végén, (például https://github.com/facebook/react/contribute).

Az alábbiakban találsz néhány oldalt, amelyek segítenek abban, hogy felfedezd és megtaláld az új projektedet:

Egy ellenőrző lista, mielőtt részt vennél a projektben

Ha találtál egy projektet, amelyhez hozzájárulnál, végezz előtte egy gyors ellenőrzést. Bizonyosodj meg arról, hogy alkalmas-e a külső hozzájárulások fogadására. Máskülönben előfordulhat, hogy a kemény munkádnak nem lesz eredménye.

Itt egy lista, aminek segítségével kiértékelheted, hogy a projekt alkalmas-e egy új résztvevőnek.

Megfelel a nyílt forráskód definíciójának

A projekt aktívan fogadja a hozzájárulásokat

Nézd meg a közösség aktivitását a master ágon. A GitHub-on ezeket az információkat a projekt főoldalán eléred.

Nézd meg a projekt hibakezelőjét.

Most csináljuk meg ugyanezt a projekt kódbeolvasztási kéréseire (pull request).

Barátságos projekt

Egy barátságos és befogadó projekt azt jelzi, hogy az új résztvevőket szívesen várják.

Hogyan kell hozzájárulni?

Végül megtaláltad a projekted és készen állsz a részvételre! Nézzük, hogyan tudsz valóban jól hozzájárulni!

Hatékony kommunikáció

Akár csak egyszeri résztvevő vagy, vagy csatlakoznál a közösséghez, a másokkal való együttműködés az egyik legfontosabb képesség, amit a nyílt forráskódú munkád során fejleszteni tudsz.

Mielőtt hibát jelzel, beolvasztást kérelmezel vagy esetleg kérdéseket teszel fel a csevegésben, tartsd szem előtt ezeket a pontokat a hatékonyabb munka érdekében.

Add meg a téma leírását! Ezzel segítesz másoknak, hogy gyorsan felvegyék a téma fonalát. Ha belefutsz egy hibába, akkor magyarázd el részletesen hogyan idézted azt elő, és hogy hogyan lehet reprodukálni. Ha új ötlettel állsz elő, magyarázd el, hogy miért gondolod úgy, hogy az hasznos lesz a projektnek (és nem csak neked)?

😇 “X nem történik, ha azt csinálom, hogy Y”

😢 “X hibás! Kérlek, javítsátok!”

Először végezd el a házi feladatot! Teljesen rendben van ha nem értesz dolgokhoz, de mutasd meg azt, hogy megpróbáltad! Mielőtt segítséget kérsz, győződj meg róla, hogy átnézted a projekt README-jét, dokumentációját, nyitott és lezárt hibajelzéseit, a levelező listát és keress rá a problémára az interneten. Az emberek értékelni fogják, ha látják, hogy próbálsz tanulni.

😇 “Nem vagyok benne biztos, hogy hogyan oldjam meg az X dolgot. Átnéztem az útmutatókat, de nem találtam erről említést.”

😢 “Hogyan csináljam meg az X dolgot?”

Légy tömör és egyértelmű! Hasonlóan az email küldéséhez, minden hozzájárulás esetén szükséges az – függetlenül attól, hogy mennyire egyszerű vagy mennyit segít –, hogy más is átnézze. Számos projektnek több beérkező módosítási igénye van, mint ahányan dolgoznak rajta. Ezért az észrevételeid legyenek tömörek és egyértelműek, így nagyobb eséllyel kapsz segítséget.

😇 “Szeretnék írni egy API útmutatót.”

😢 “Épp vezettem az autópálya lehajtón egy nap és megálltam tankolni, és ekkor egy hatalmas ötlet jutott az eszembe, amit meg kellene csinálnunk, de mielőtt elmagyaráznám, hadd meséljek a …“

Legyen nyilvános a kommunikációd! Bár csábító, de a karbantartókat ne privát csatornákon keresd; kivéve, ha érzékeny információt (biztonsági incidens, komoly viselkedési szabályok megsértése) kell megosztanod. Ha a kommunikáció publikus, akkor több ember tud tanulni belőle, mindenkinek hasznára válik. A publikus megbeszélések már önmagukban is hozzájárulások a projekthez.

😇 (megjegyzésként:) “@-karbantartó Szia! Mi legyen ennek a Pull Request-nek a sorsa?”

😢 (emailként:) “Szia! Sajnálom, hogy a levelemmel zavarlak, de kíváncsi lennék rá, hogy van-e esély a Pull Requestem beolvasztására?”

Rendben van, hogy kérdezel, de legyél türelmes! Mindenki volt kezdő az adott projekten, még a gyakorlott résztvevőknek is fel kell venni a tempót egy új projekt esetén. Ugyanígy, még a régebbi karbantartók sem mindig ismerik a projekt minden részét. Légy velük olyan türelmes, mint amilyet te is elvárnál tőlük.

😇 “Köszönöm, hogy megnézted ezt a hibát. Követtem az utasításaidat, itt a végeredménye:”

😢 “Miért nem javítod a jelzett problémámat? Ez nem a te projekted?”

Tartsd tiszteletben a közösség döntéseit! Az ötleteid eltérhetnek a közösség céljaitól vagy jövőképétől. Ötleteidre kaphatsz visszajelzést, vagy akár el is utasíthatják azt. Míg lényeges, hogy egyeztess és keresd a kompromisszumot, tartsd észben, hogy a karbantartóknak a hosszabb távon kell a te döntéseddel együtt élni, mint neked. Ha nem értesz egyet az iránnyal, bármikor létrehozhatod a saját elágazásodat (fork) a kódból, vagy akár kezdhetsz egy új projektet.

😇 “Bár szomorú vagyok, hogy nem támogatjátok az ötletemet, de ahogy elmagyaráztátok, megértettem azt, hogy ez az eset csak kevés embert érint. Köszönöm, hogy meghallgattatok!”

😢 “Miért nem támogatjátok az ötletem? Ez elfogadhatatlan!”

Mindenekelőtt: ne légy ízléstelen! A nyílt forráskódon együttműködők a világ számos részéről származnak. A kontextus gyakran elveszik a nyelvi-, kulturális-, földrajzi- és időzóna különbségek miatt. Ráadásul az írott kommunikáció megnehezíti a hangulat vagy a hozzászólás érzelmi részének közvetítését. Tételezz fel jó szándékot a beszélgetésekben. Teljesen elfogadható, ha udvariasan visszautasítasz egy ötletet, vagy megkérsz valakit, hogy adjon további információt a problémáiról. Próbáld az Internetet tisztábban ott hagyni, mint ahogy találtad.

Összefoglalás

Mielőtt bármibe belekezdenél, győződjön meg róla, hogy az ötletedet nem vitatták-e már meg máshol. Nézd meg a projekt README-jét, a nyitott és lezárt hibajegyeket és kérdéseket, a levelezőlistát és a StackOverflow-t. Nem kell órákat töltened azzal, hogy átnézz mindent, de egy gyors keresés néhány kulcsszóra nem tart semeddig.

Ha nem találod meg a felvetést sehol, akkor mehetsz tovább. Ha a projekt a GitHub-on van, akkor nyithatsz egy hibajegyet vagy létrehozhatsz egy beolvasztási kérést a módosított kód alapján:

  • Issues (hiba, észrevétel) olyanok mint egy párbeszéd, vagy egy megbeszélés
  • Pull requests (beolvasztási kérelem) szolgál a munka megkezdésére
  • Egyszerű kommunikációra, például tisztázó- vagy a “Hogyan…” kérdésekre használd a StackOverflow-t, IRC-t, Slack-et vagy egyéb rendelkezésre álló csevegő csatornát, ha van ilyen a projektben

Mielőtt hibajegyet, észrevételt vennél fel, vagy egy beolvasztási kérelmet benyújtanál, ellenőrizd a projektben való részvételről szóló dokumentációt (ezt gyakran a CONTRIBUTING vagy a README tartalmazza), mert lehetséges, hogy mellékelned kell valamilyen specifikus információt is. Például, a projekt kérheti azt, hogy egy űrlapot tölts ki, vagy megkövetelheti a teszteket.

Ha jelentősebb munkával akarsz részt venni, akkor nyiss egy probléma felvetést tartalmazó jegyet, ahol a kérdéseket meg lehet vitatni, mielőtt még nekikezdenél. Hasznos, ha egy darabig csak nyomon követed a projektet és a közösséget (a GitHub-on, klikkents a “Watch” linkre hogy értesítést kapj az összes beszélgetésről), hogy megismerd a tagjait, mielőtt olyan munkát végeznél benne, amit nem fogadnak el.

Hibajegy nyitása

Általában a következő helyzetekben kell hibajegyet (Issue) nyitni:

  • Hiba jelentése, amelyet nem tudsz megoldani egymagad
  • Magas szintű probléma vagy téma, esetleg ötlet megbeszélése (például: közösség, vízió vagy szabályok)
  • Új funkció javasolása, vagy más projekt célok, ötletek

Tippek a jó párbeszédhez:

  • Ha nyitsz egy hibajegyet, amit meg szeretnél oldani, kommenteld azt, így más is tudja, hogy foglalkozol vele. Így mások nem dolgoznak ugyanezen feleslegesen.
  • Ha a hibajegy már régóta nyitott, akkor lehetséges, hogy már máshol foglalkoznak vele, vagy már meg van oldva, így célszerű egy kommentben megkérdezni az állapotát, mielőtt elkezdesz rajta dolgozni.
  • Ha nyitottál egy hibajegyet és később magadtól rájöttél a megoldásra, akkor kommentezz, hogy más is megismerje azt, majd zárd le a hibajegyet. Az eredmény dokumentálása is nagyon fontos a projektnek.

Beolvasztási kérelem megnyitása

Általában a következő esetekben szükséges beolvasztási kérelmet nyitni:

  • Triviális javítások küldése (például egy gépelési hiba, hibás link vagy nyilvánvaló hiba)
  • Olyan feladaton történő munka elkezdése, amelyet már a közösség kitárgyalt, átbeszélt és tisztáztad a kérdéseket

A beolvasztási kérelem nem feltétlen jelent befejezett munkát. Gyakran jobb korán megnyitni ezt, így mások megfigyelhetik és visszajelzéseket adhatnak róla. Csak jelöld meg “WIP” (Work in Progress) jelzéssel a tárgy soron. Ezek után bármikor, szabadon adhatsz hozzá új kódot (commit és push).

Ha a projekt a GitHub-on van, akkor a következőképpen kell beolvasztási kérelmet benyújtani:

  • Ágaztasd (fork) el a kód tározót és klónozd le magadhoz lokálisan. A lokális másolatodat kapcsold az eredeti tárolóhoz (original “upstream”) egy remote hozzáadásával. Frissítsd minél gyakrabban a változásokat az “upstream”-ről, hogy naprakész maradj. Így beolvasztás esetén kisebb eséllyel lesz ütközés a kódok összefésülésekor. (Részletes instrukciókat itt találsz.)
  • Hozz létre egy új ágat (branch) a módosításaidhoz.
  • Hivatkozz meg bármilyen releváns hibajegyet vagy a dokumentációt a beolvasztási kérelmedben (például, “Closes #37.”)
  • Adj hozzá a kérelmedhez “előtte” és “utána” képernyőképeket ha HTML/CSS változás történt. Húzd be a képeket a beolvasztási kérelembe.
  • Teszteld a változtatásokat! Mindig futtasd le a meglévő teszteket a kódodon, vagy írj újakat ha szükséges. Függetlenül a tesztektől bizonyosodj meg arról, hogy a módosításod nem rontja-e el a projektet.
  • A módosításaidnál alkalmazkodj a projekt kódolási stílusához a legjobb tudásod szerint. Ez jelentheti azt, hogy más sorbehúzást kell használni a szövegben, lehet hogy a projekt használ pontosvesszőt, de te nem szoktál, vagy másként írják a kód kommenteket, mint ahogy te szoktad. Ha ezt betartod, a karbantartóknak könnyebb a kódot összefésülni (merge), másoknak pedig karbantartani és megérteni azt.

Ha ez lesz az első beolvasztási kérelmed (Pull Request), akkor nézd ezt meg előtte: Make a Pull Request, amelyben @kentcdodds egy részletes videó anyagot készített. A beolvasztási kérelmek benyújtását a @Roshanjossey által készített First Contributions GitHub projekten is gyakorolhatod.

Mi történik miután beküldted a kész beolvasztási kérelmedet?

Megcsináltad! Gratulálunk, a nyílt forráskód résztvevője lettél. Reméljük ezt az első lépést majd még számos követi.

Miután beküldted a végleges hozzájárulásod a projekthez, a következők történhetnek:

😭 Nem kapsz választ

Remélhetőleg ellenőrizted a projekt aktivitását mielőtt csatlakoztál hozzá. Még egy aktív projekt esetén is előfordulhat, hogy nem kap választ azonnal a résztvevő.

Ha nem kapsz válasz egy hét alatt sem, akkor udvariasan, ugyanazon a szálon kérj meg valakit, hogy nézze át a munkádat, ez így elfogadható. Ha tudod, ki lenne ez a személy akkor meg is említheted őt a @-mention forma használatával.

Soha ne követlenül, privát csatornán lépj kapcsolatba ezzel a személlyel; emlékezz, a publikus kommunikáció az egyik fontos alapja a nyílt forráskódnak.

Ha az udvarias kérésedre sem reagált senki, akkor lehet, hogy soha nem is fog. Ez lehangoló lehet, de ne add fel, mindenkivel megtörténhet! Számos oka lehet annak, hogy nem kaptál választ, mint például olyan személyes problémák, körülmények, melyekre nincsen ráhatásod. Próbálj meg másik projektet találni, vagy más módon hozzájárulni a projekthez. Ez egy jó példa arra, hogy miért ne tegyél bele túl sok munkát, mielőtt a közösség többi tagja nem reagál az ötletedre.

🚧 Valaki módosítást kér a munkádon

Gyakran előfordul, hogy valaki módosítást kér a munkádon, amely lehet egy tisztázó kérdés, vagy egy kód módosítási igény.

Amikor valaki ilyet kér, reagálj rá, hiszen vette a fáradtságot és időt áldozott rá, hogy a munkádat áttekintse. Nagyon rossz gyakorlat az, ha beolvasztási kérelmedet leadtad és utána nem foglalkozol már vele. Ha nem tudod, hogy a kérést hogyan teljesíthetnéd, akkor kutass, olvass és ha szükséges kérdezz vagy kérj segítséget.

Ha már nincs többé időd, hogy a problémán dolgozz (például időközben több hónap eltelt és megváltoztak a körülményeid), akkor jelezd a karbantartók felé, hogy tudják ezt. Lehet, hogy valaki más örömmel átvenné a feladatot.

👎 Nem fogadták el a munkád

A munkádat végül vagy elfogadják, vagy nem. Remélhetőleg még nem tettél bele túl sok munkát. Ha nem vagy benne biztos, hogy miért utasították el a hozzájárulásodat, nyugodtan kérdezz és tisztázd az okokat. De végül mindig tartsd tiszteletben a döntést! Ne vitatkozz feleslegesen és ne légy ellenséges! Bármikor megteheted, hogy elágaztatod a projektet (fork) és a saját verziódon dolgozol, ha nem értesz egyet.

🎉 Elfogadták a munkád

Hurrá! Sikeresen hozzájárultál a nyílt forráskódhoz!

Megcsináltad!

Legyen szó az első nyílt forráskódú munkádról, vagy arról hogy új módját keresed a hozzájárulásnak, reméljük adtunk egy kis inspirációt a cselekvéshez. Még ha nem is fogadták el a hozzájárulásodat, ne feledj el köszönetet mondani a karbantartóknak, hogy energiát szántak rád és a munkádra. A nyílt forráskódot épp olyan emberek alakítják mint te: egy hibajelzés, egy beolvasztási kérés (Pull Request), néhány komment, vagy csak egy egyszerű köszönet.