Portofoli GitHub: pesë projekte vlejnë më shumë se një mur me depo

Për ta kthyer profilin GitHub në provë të aftësive për punë, fikso tri deri në pesë projekte që lidhen me rolin e synuar. Udhëzimi zyrtar i GitHub për profilin në CV rekomandon 3–5 projekte me aftësi të larmishme; pesë është kufiri i sipërm i kësaj përzgjedhjeje. Për secilin projekt, përgatit një README që shpjegon funksionin, mënyrën e nisjes, një shembull ose demonstrim dhe si ekzekutohen testet.

Kjo punë mund të organizohet gjatë një fundjave: pastro pjesën e dukshme të profilit, zgjidh depot që ia vlen të hapen dhe provo udhëzimet e tyre si vizitor. Qëllimi është që dikush që vjen nga CV-ja të kuptojë çfarë ke ndërtuar, cilat vendime ke marrë dhe ku shihet rezultati, pa kërkuar mes shumë depove me emra të paqartë.

Pastro hyrjen e profilit

Nis me biografinë: thuaj shkurt çfarë pune kërkon dhe në cilën fushë punon, për shembull zhvillim uebi, të dhëna ose aplikacione me AI. Nëse përdor një README të profilit, përmend aty punën dhe aftësitë që do të dalin edhe te projektet e fiksuara. Një listë e gjatë teknologjish nuk e ndihmon lexuesin nëse depot e dukshme nuk tregojnë si i ke përdorur.

Shiko pastaj çfarë shfaqet menjëherë poshtë përshkrimit. Hiq nga vendet e fiksuara kopjet e ushtrimeve, eksperimentet pa shpjegim dhe projektet e përbashkëta ku kontributi yt nuk dallohet. Mund t’i mbash këto depo në llogari; vendet e dukshme duhen rezervuar për punë që je gati ta hapësh dhe ta shpjegosh në intervistë. Kontrollo që roli i shkruar në bio të përputhet me CV-në dhe që lidhja e profilit në CV të çojë te llogaria e duhur.

Zgjidh projekte që tregojnë aftësi të ndryshme

Vlerëso çdo kandidat për vend të fiksuar me një pyetje: çfarë mëson për punën time dikush që hap këtë depo? Një aplikacion i përfunduar mund të tregojë si ndërton një rrjedhë nga hyrja te rezultati; një mjet më i vogël mund të tregojë trajtimin e gabimeve; një kontribut në kod të përbashkët mund të tregojë bashkëpunimin. Këto janë mundësi për një përzgjedhje të larmishme, jo kategori që çdo kandidat duhet t’i plotësojë.

Për një rol në AI, mos u mbështet vetëm te emri i modelit ose i bibliotekës së përdorur. Jep përparësi projektit ku mund të shpjegosh problemin, të dhënat ose hyrjet që përdor, pjesën që ke ndërtuar vetë dhe mënyrën si ke kontrolluar daljen. Për një rol tjetër, ndrysho përzgjedhjen sipas aftësive që kërkon puna. Një depo që lidhet drejtpërdrejt me rolin dhe ka rezultat të hapshëm i jep shqyrtuesit më shumë për të vlerësuar sesa një tjetër që përsërit të njëjtin ushtrim.

Nëse projekti është fork ose punë në grup, shëno ndryshimin tënd konkret në përshkrim ose në README. Për punë ndërkombëtare në distancë, dokumentimi kryesor duhet të jetë i kuptueshëm në gjuhën e ekipit ku aplikon; për role lokale, zgjidh gjuhën që i shërben lexuesit të CV-së. Përzgjedhja mund të jetë më e vogël se hapësira e disponueshme kur projektet e tjera ende nuk janë gati për t’u paraqitur.

Jepi çdo depoje një README që e hap punën

README-ja duhet t’i përgjigjet pyetjeve që lindin para leximit të kodit: çfarë bën projekti, për kë është ndërtuar dhe si provohet? Hape me një përshkrim të thjeshtë të funksionit dhe të problemit. Më pas trego veçoritë kryesore dhe një vendim teknik që mund ta shpjegosh, si trajtimi i një hyrjeje të pavlefshme ose zgjedhja e një mënyre ruajtjeje.

1. Shëno çfarë ke ndërtuar vetë, sidomos kur depoja ka bashkëpunëtorë ose mbështetet në një projekt ekzistues.
2. Vendos një lidhje demonstrimi që hapet ose një shembull konkret të hyrjes dhe daljes së programit.
3. Jep kërkesat, hapat për instalim e nisje dhe komandën për ekzekutimin e testeve.
4. Përmend shkurt një kufizim real dhe çfarë do të ndryshoje në një version tjetër.

Përshtate këtë rend me llojin e projektit. Për një bibliotekë, një shembull përdorimi mund të jetë më i dobishëm se pamja e një ndërfaqeje; për një aplikacion, vizitori duhet ta gjejë lehtë rrjedhën kryesore. Nëse nisja kërkon një shërbim të jashtëm ose të dhëna të veçanta, thuaje qartë dhe jep një mënyrë të sigurt për t’i konfiguruar, pa vendosur çelësa privatë në depo.

Provo demonstrimin, testet dhe historinë e punës

Hape lidhjen e demonstrimit në një dritare ku nuk je i identifikuar. Ndiq rrjedhën kryesore dhe krahasoje me atë që premton README-ja; pastaj provo hapat e nisjes nga udhëzimet e publikuara. Kur demonstrimi publik nuk është i mundur, një shembull i qartë i hyrjes dhe daljes ose udhëzime të plota për nisjen lokale mund ta bëjnë rezultatin të kuptueshëm.

Testet japin një mënyrë tjetër për të parë si e kontrollon sjelljen e programit. Për projektin që do të paraqesësh më shpesh, mbulo të paktën rrjedhën kryesore dhe një rast gabimi që ka kuptim për të; sigurohu që komanda e dokumentuar punon me versionin e publikuar. Nëse verifikimi është ende manual, përshkruaj saktë çfarë ke provuar, në vend që të lësh përshtypjen se ekzistojnë teste të automatizuara.

Historia e ndryshimeve mund të tregojë si ke arritur te zgjidhja. Këshillat e GitHub për zhvilluesit e rinj propozojnë issues, commits dhe project boards për ndjekjen e përparimit, si edhe shënimin e etapave në README. Shkruaj mesazhe commits që emërtojnë ndryshimin; një issue që përshkruan problemin dhe një ndryshim që e zgjidh japin kontekst më të qartë se një varg përditësimesh të quajtura thjesht «update».

Bëj kontrollin e fundit si vizitor

Analiza e Offer·Code për shqyrtimin e GitHub përshkruan një vështrim prej rreth 90 sekondash, të përqendruar te depot e fiksuara, README-ja dhe ndonjëherë historia e commits. Ajo e trajton grafikun e kontributeve si sinjal të dobët; koha e përmendur është një skenar i shqyrtimit të shpejtë, jo rregull për çdo punëdhënës.

Hape profilin si vizitor dhe nis nga bioja. Zgjidh një depo të fiksuar, gjej çfarë bën projekti, hape demonstrimin dhe shiko si nisen testet. Nëse një lidhje është prishur, emri nuk tregon çfarë ke ndërtuar ose udhëzimet kërkojnë shpjegim gojor, rregulloje atë pengesë përpara se ta vendosësh profilin në CV.

Lexoni gjithashtu:

• Investimet në AI rriten, por 61% nuk presin shumë vende të reja pune
• Coursera apo edX: abonimi fiton vetëm kur përfundon më shumë se një kurs
• Trello apo Asana: çmimi përgjysmohet, por projektet komplekse kushtojnë