Első hacktoberfestöm - Nyílt forráshoz való hozzájárulás első időzítőként való tapasztalatai

Ijesztőnek 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: ehhez sem a sörhez, sem a hackeléshez, sem az Oktoberfest-hez (amely valójában szeptemberben kerül sor, duh!)

A Hacktoberfest egy október 1-jétől október 31-ig tartó, az Open Source-hoz való hozzájárulás egy hónapos ünnepe. A kezdete a DigitalOcean, a GitHub-szal együttműködve. 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ó ezt a szépségét kapja meg, miután teljesítette a Hacktoberfest-t (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! 
// Ezután klónoznia kell a villás repo git klónt, a git@github.com címet: felhasználónév / hozzájáruló-repo.git
// Változtassa meg a könyvtárat az új repo-ra, amelyet klónozott cd hozzájárul-repo-ra
// Állítsa be az upstream lerakatot az eredeti lerakatra (nem azt, amelyet éppen klónozott) git remote add upstream git@github.com: a-tulajdonosok-felhasználónév / hozzájáruló-repo.git
// Frissítse az összes változást, amelyet a gördülék fel
// Állítsa be a fő águnkat ugyanolyanra, mint az upstream ág git ágát - set-upstream-to = upstream / master master
// Készítsen saját új fiókot 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 (a módosított fájloknak meg kell mutatniuk) git status
// nézd meg a változásokat és értékeljék újra a munka különbségét
// adjon hozzá változtatásokat az átmeneti területhez (. minden fájlhoz) git add 
// Végezzen el minden változást, és adjon hozzá egy üzenetet a repo git vállalkozás fenntartója számára -m "Ezt a hűvös szöveget hozzáadtam az útmutató tárolójához"
// Nyomja meg a repo forrását, és hozzon létre pull request git push orig pr / my-new-cool-hozzájárulást

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 állítanom a játékomat, és meg kellett találnom két másik kérdést.

A meccs a mennyben készült - hozzájárul a freeCodeCamp útmutatókhoz

Egy nap kinyitottam a Medium szolgáltatást, é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 tárolójá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 megtalálása nem volt nehéz, mivel az útmutatók tárháza bármit lefedt 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ást, forrásokkal támasztottam alá é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 egy 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ők számára 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ött, 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. Ennek viselése 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őszemű!