Új közreműködési irányelvek

If egy automatikusan lezárt Issue/PR-ből irányítanak ide, kérünk, ne ess pánikba, és ne érezd magad elutasítottnak. A legtöbbször előbb-utóbb bekerül az Exercism-be minden munka, amit elvégeztél, vagy megoldódik a problémád. Örömmel fogadjuk és bátorítjuk a közreműködést, de szeretjük megbeszélni a dolgokat a fórumunkon, mielőtt belevágunk a GitHubon található kódba. Egy fórumtéma nyitása előrébb viszi a dolgokat.

Az elmúlt egy évben azzal kísérleteztünk, hogy korlátozzuk a nem karbantartók közreműködéseit, hogy ezzel időt szabadítsunk fel a fő közreműködőink számára, és lehetővé tegyük nekik, hogy jelentősebb fejlesztéseket hajtsanak végre a kurzusokon. Ez egészen jól működött. A 2022-es évhez képest 2023-ban kétszer annyi új feladat került be, és háromszor annyi tanterv született. A módszerváltás sokkal nagyobb lélegzetű közreműködéseket tett lehetővé, valamint kevesebb frusztrációt és kevesebb zavaró tényezőt jelentett a fő közreműködőink számára.

Ugyanakkor azt is látom, hogy ez frusztrációt okozott azoknak az új közreműködőknek, akik elkötelezetten segíteni szeretnének, de úgy érzik, hogy a közreműködési folyamatunk elzárja őket ettől. Ezért ma szeretnék bemutatni néhány új (vagy pontosított) irányelvet arra vonatkozóan, hogyan fogunk tovább haladni a közreműködésekkel a következő néhány hónapban.

Az alapvető szabály, amit érdemes megérteni: az ötleteket, hibákat és problémákat a fórumunkon beszéljük meg, a kódon alapuló változásokat pedig a GitHubon (PR-áttekintések során). A másodlagos szabály, hogy (a függetlenül működő karbantartók kivételével) előbb megbeszéljük a dolgokat, aztán cselekszünk. A fórumunk lehetővé teszi, hogy a közreműködők és a karbantartók a kurzusokon átívelően osszák meg a tudásukat és a tapasztalataikat a programozási nyelvek és ötletek széles skálájáról, anélkül hogy 300 különböző GitHub-tárolóra kellene feliratkozniuk, és túlterhelniük az értesítéseiket.

Frissített útmutatás

Segítség kérése

• Ha elakadsz valamiben, mielőtt megoldanál egy feladatot (például a CLI telepítése, a tesztek futtatása, vagy egy feladat logikája és követelményei), a támogatási csatornáink a fórumon található „Exercism Support” kategória, valamint a Discord-szerverünk #get-help csatornája.
• Támogatási kérésekhez nem használunk GitHubot vagy e-mailt.
• Ha már megoldottál egy feladatot, de kérdéseid vannak vele kapcsolatban, mentorálást kérhetsz magán az Exercism-ön.

Hibák és problémák bejelentése

• Minden hibát és problémát a fórumunkon érdemes bejelenteni, ahol sokféle ember segíthet megérteni és megoldani a problémát.
  • Ha a probléma egy programozási nyelvhez kapcsolódik, használd a megfelelő Programming/xxx kategóriát.
  • Ha a weboldalon található hiba, használd a „Bugs & Feature Requests” kategóriát.
• A GitHub-issue-kat általában automatikusan lezárjuk, és a bejelentőt átirányítjuk a fórumra (egy kattintással másolható linkkel, amellyel beillesztheti a problémáját, ahogy jelenleg is történik).
• A kurzuskarbantartók kikapcsolhatják az automatikus issue-lezárást, de a hivatalos útvonal továbbra is a fórum.

Pull requestek nyitása

• A Pull Requesteket a fórumon kell megbeszélni, mielőtt a munka elkészül.
• A nem szervezeti tagoktól érkező Pull Requestek továbbra is automatikusan lezárásra kerülnek, de gyakran újra megnyitjuk őket, miután a munkát megbeszélték a fórumon. Ha a PR mögött álló ötletet már jóváhagyták, egyszerűen adj hozzá egy linket a PR-hoz a megfelelő fórumtémában, és újra megnyitjuk.
• A kurzuskarbantartók kikapcsolhatják az automatikus PR-lezárást, de továbbra is azt javasoljuk, hogy minden PR-t először a fórumon beszéljünk meg.

Összefoglaló

Az elsődleges prioritásunk továbbra is a fő közreműködőink idejének és mentális kapacitásának a védelme, akik nélkül az Exercism nem tud működni. De azt is szeretnénk biztosítani, hogy az Exercism olyan hely maradjon, ahol új emberek is bekapcsolódhatnak túlzottan gátló akadályok nélkül, és ahol bátoríthatjuk és támogathatjuk őket abban, hogy maguk is fő közreműködőkké váljanak!

Izgatottan várom, hogy ezek a változások hogyan hatnak majd a közreműködésekre a következő néhány hónapban. 2024 közepén újra áttekintjük a dolgokat.