Első hacktoberfestöm - A nyílt forráshoz való elsődleges hozzájárulás tapasztalatai

Idősnek tűnhet a nyílt forráskódhoz és a projektekhez való hozzájárulás. Kedvenc keresőmotorja rengeteg találatot eredményez az útmutatókban és a tárolókban az induláshoz. De sokszor a keresése nem hozza meg a kívánt eredményt, még mindig nem tudja, hogyan járulhat hozzá az Open Sourcehoz, még több blogbejegyzés elolvasása után is. Bizonyos projektek hátrányos hírneve és a durva felhang nem szintén segít, és tovább bonyolíthatja az ügyeket.

Én magam is ott voltam. Átmentem az oldalakon, hogy nagyszerű nyílt forráskódú tárolókat találjak, amelyekhez hozzájárulhatnék, csak észrevettem, hogy nem tudom, hogyan kezdjem.

Csalódottan és kissé csalódottként inkább más projektekre összpontosítottam.

De mindez megváltozott, amikor láttam egy alkalmazott munkatársának a Hacktoberfest matricáját a laptopjukon. Érdekes voltam - ez egy újabb Hackathon maradványa?

A Hacktoberfest nagyon különbözőnek bizonyult.

Tehát mi is a Hacktoberfest pontosan?

Tipp: nem kell sem a sörhez, sem a hackeléshez, sem az Oktoberfest-hez (ami valójában szeptemberben zajlik, duh!).

A Hacktoberfest október 1-jétől október 31-ig tartó, egy hónapos ünnepség az Open Source-hoz való hozzájárulásról. A kezdeményezést a DigitalOcean, a GitHub-szal együttműködve kezdeményezte. Október hónapja során ösztönzik Önt, hogy közreműködjön, és vonzó kéréseket tegyen kedvenc tárolóinak a GitHub-on. Ha sikerül összesen négyet elkészítenie, akkor jogosult lesz egy ilyen nagyszerű pólóra!

A pólónak ez a szépsége az, amit a Hacktoberfest kitöltése után kapsz (Hitel: @mahsinger a Twitteren)

Címkék, címkék, címkék

A Hacktoberfest nagyszerű hónapnak bizonyult a nyílt forráskódba való bejutáshoz. A GitHub tele volt Hacktoberfest feliratú kérdésekkel, amelyekre szükség volt a segítségedre. Elég volt a választható projektek közül - a dokumentációtól a Python-ig a RUST-ig. Ez idő alatt megtanultam, hogyan lehet címkék szerint keresni a GitHub-ban a kérdéseket, és hogyan találhat jó kérdéseket, amelyekhez hozzájárulhat.

Azokhoz az emberekhez, akiknek nincs tapasztalata, az olyan címkék, mint a csak első alkalommal kiadott, az egyszerű vagy a jó első kiadás, barátomnak bizonyultak. Vannak néhány jó webhely is, amelyek célja, hogy megkönnyítsék e kérdések megtalálásának folyamatát. Például a up-for-grabs.net vagy a code-triage - valószínűleg még sok más.

Menj, és iratkozz fel ezek közül néhányra, vagy nézd meg kérdéseiket!

Megtanuljuk, hogyan járulhat hozzá

Az első hozzászólásom megkísérlése közben rájöttem, hogy a legnagyobb ismerettem nem az volt, hogy linkeket adjunk a jelöléshez vagy az oldal stílusát. De hogyan lehet egy jó pull kérést tenni a git és a parancssor segítségével.

Hasznosnak találtam Kent C. Dodds ingyenes útmutatóját a egghead.io webhelyen, és feljegyeztem a parancssori parancsokat, amelyeket futtattam, miközben követem.

Az utasításokat az alábbiak szerint össze lehet foglalni:

// Először meg kell találnia egy tárolót, amellyel hozzájárulhat, és elkészítheti azt!
// Akkor ki kell klónoznod a villás repót
 git klón git@github.com: felhasználónév / hozzájáruló-repo.git
// Változtassa meg a könyvtárat az új repójához, amelyet klónozott
 cd hozzájáruló-repo
// Állítsa be az upstream lerakatot az eredeti lerakatra (ne az éppen klónozottra)
 git remote add upstream git@github.com: a-tulajdonosok-felhasználónév / hozzájáruló-repo.git
// Frissítse a módosításokat
 git fetch upstream
// Állítsa be a fő ágot ugyanolyanra, mint az upstream ágot
git ág - set-upstream-to = upstream / master master
// Hozzon létre saját új ágot a pull kéréshez
git checkout -b pr / my-new-cool-hozzájárulás
// Végezzen változtatásokat a kedvenc szövegszerkesztőben, és mentse
// állapot ellenőrzése (meg kell jeleníteni a módosított fájlokat)
git állapot
// nézd meg a változásokat és értékelje újra a munkát
git diff
// adjon hozzá változtatásokat a megállítási területhez (. minden fájlhoz)
add hozzá
// Végezzen el minden változtatást, és küldjön üzenetet a repó fenntartója számára
git activ -m "Ezt a hűvös szöveget hozzáadtam az útmutató tárolóhoz"
// Nyomja meg a repó forrásához, és hozzon létre pull kérést
git push orig pr / my-new-cool-hozzájárulás

Ez tényleg segített nekem megérteni a pull-kérés célját és a hozzájárulás folyamatát. Ez a blogbejegyzés azt is megértette, hogy a leíró jellegű a legjobb fegyver - így támogatást kaphat, és jelezheti, hogy a pull kérés még folyamatban van. Nem sokkal később, újabb gyakorlati hozzájárulást tettem, de ahhoz, hogy pólót kapjak, fel kellett állnom a játékomra, és meg kellett találnom két másik kérdést.

A mennyországban megrendezett mérkőzés - hozzájárulva a freeCodeCamp útmutatókhoz

Egy nap kinyitottam a Médiumot, és láttam, hogy Quincy Larson teljes útmutatót nyújtott arról, hogy az emberek hogyan tudnak könnyedén hozzájárulni a freeCodeCamp útmutatók adattárához. A megosztott tudás forrása a fejlesztés, a termék, a formatervezés és az adattudomány területén. A tárolóhoz való hozzájárulás nemcsak erőteljesen ösztönözte, hanem rendkívül egyszerű is. A hozzájárulásokat a böngészőjében teheti meg.

A téma megkeresése nem volt nehéz, mivel az útmutatók tárolói bármit lefedtek az akadálymentességtől a HTML-ig a játékfejlesztésig.

A leginkább az volt, hogy a freeCodeCamp mennyire könnyűvé tette a folyamatot, hogy lehetővé tegyék az énhez hasonló újonnan érkezők számára, hogy érthető módon járuljanak hozzá. Tudás megosztása másokkal.

Még mindig megtanulta a pull pull kérést, az összevonását, a szabványok betartását és az iránymutatások betartását. A folyamat kissé kevésbé volt megfélemlítő. Ideális volt egy kezdő számára. Valójában az ésszerűsítés miatt a freeCodeCamp gif-et tudott készíteni róla, amely összefoglalja a folyamatot:

Hitel: freeCodeCamp - Hozzájárulás a freeCodeCamp útmutatók tárházához

Néhány mérlegelés után úgy döntöttem, hogy kicsit hozzájárulok a különféle Linux disztribúciókhoz. És írjon egy teljesen új részt a Játékfejlesztésről, hogy teljesítse a négy húzási kérelmet. Dolgozatom részeként nyáron játékot készítettem. A játékfejlesztésről és az eszközökről való írás jó módszernek tűnt az újonnan megszerzett ismereteim megosztására másokkal.

A Contributing.md iránymutatásukban a freeCodeCamp sok részletet és módot adott meg annak biztosítására, hogy az írása tömör legyen. Megtették az összes kutatásomat, támasztottam alá forrásokkal, és a Hemingway alkalmazáson keresztül tüzeltem. Aktív hang és rövid mondatok a győzelemért!

Megtettem a húzási kérelmet, és a hold fölött voltam, amikor összeolvadtak. A bátorító visszajelzés szintén nagy plusz a freeCodeCamp közösség részéről.

Pull Request for Game Development szakasz, amelyet a freeCodeCamp útmutatókhoz írtam

Mit távolíthatunk el ettől?

Azt tanácsolnám, hogy szabaduljon fel abból a feltételezésből, hogy először hozzá kell adnia a tökéletes és jól lekerekített kódot. Az első hozzászólásnak nem feltétlenül kell úttörőnek lennie (vagy akár pontosnak is kell lennie).

A projektfenntartók tudják, hogy ez lehet az első nyílt forráskódú hozzájárulása, ha a kérdést csak első alkalommal jelölték meg vagy hasonlóként. A hozzájárulás bármilyen lehet, például helyesírási hiba kijavítása, néhány hivatkozás hozzáadása vagy egy kis tanulási projekt. Kezdje kicsivel, hogy megismerje a folyamatot.

Számos projektfenntartó, akik kérdéseiket kezdőknek barátságosnak jelöli, szívesen válaszol kérdéseire és támogatást nyújt. Tehát ne félj magyarázatot kérni, ha nem ért valamit.

Amikor december közepén végül megérkezett a Hacktoberfest póló, egész Amerikából szállítva, úgy éreztem, hogy a karácsony korán eljött. A kezemben tartva rájöttem, hogy segített létrehozni és kiterjeszteni valamit, ami számít. Olyan érzésem, hogy hiszem, hogy sok ember rendszeresen hozzájárul az Open Sourcehoz. Hordása mindig emlékeztet arra, hogy megosszam a tudásomat, és ebben az évben megpróbálom magam is előmozdítani, hogy több kódot nyújtsak be, elvégre nem vagyok első alkalom!