Ngopi #43. 6 kesalahan pemrograman sing nyegah sampeyan entuk proyek impen. Carane Kontribusi kanggo Open Source Software kanggo pisanan

6 kesalahan pemrograman sing nyegah sampeyan entuk proyek impen

Sumber: Sedheng Kanggo golek proyek minangka programmer, sampeyan kudu duwe repositori Git. Iki minangka salah sawijining perkara sing bakal dideleng para perekrut. Kanggo repositori sampeyan nggawe kesan positif, kudu ngemot proyek kanthi owah-owahan anyar. Mung nuduhake proyek sing sampeyan banggaake, ora saben baris kode sing wis sampeyan tulis. Iki minangka dhasar nggarap repositori. Elinga yen cepet utawa mengko ana sing bakal mriksa kode sampeyan kanggo ndeleng manawa sampeyan cocog karo perusahaan kasebut. Iki bakal dadi wayahe sing nemtokake kanggo sampeyan. Sawise sawetara menit, recruiter bakal mutusake apa arep ngajak sampeyan wawancara. Lan ing kene ana kabar apik lan ala. Kabar sing ala yaiku kesalahan sing prasaja bisa ngrusak kemungkinan sampeyan entuk kerja. Kabar apik yaiku wong biasane ora pengin nggali kode. Dheweke butuh pangerten umum babagan kode lan arsitektur sampeyan. Dadi sampeyan ora kudu dadi jenius - sampeyan mung kudu dadi programmer sing apik. Ing ngisor iki sawetara kesalahan umum sing ditindakake para pemula. Nyingkiri lan kemungkinan wawancara sampeyan bakal tambah akeh.

Komentar kuna

Programer duwe panemu beda babagan komentar. Sawetara tresna marang dheweke, liyane sengit. Kita ora bisa teka menyang kesimpulan umum apa iku worth menehi komentar kode lan ing kasus apa iku. Nanging kabeh wong setuju karo siji perkara: yen sampeyan duwe komentar, mesthine cocog karo kode sampeyan. Ana komentar kanggo nerangake kode kasebut. Nalika kode sampeyan rumit utawa ora jelas, sampeyan butuh bantuan kanggo maca supaya bisa ngerti. Sampeyan uga kudu ngganti komentar nalika ngganti kode. Yen sampeyan ora nindakake iki, komentar sampeyan ora bakal migunani maneh. Komentar sing ala luwih ala tinimbang ora ana komentar. Kanggo nggawe masalah luwih elek, komentar disorot ing kode kasebut. IDE modern nyorot komentar kanthi warna sing beda supaya luwih gampang diwaca. Kanthi nambahake komentar, sampeyan menehi tandha "maca kula" ing kode kasebut. Kanthi cara iki, apa wae bedo antarane komentar lan kode bakal gampang dideteksi. Pilih komentar sampeyan kanthi wicaksana lan elinga nganyari bebarengan karo kode sampeyan. Kanthi cara iki, dheweke bakal ngladeni sampeyan kanthi becik.

Kombinasi perpustakaan lan basa kanthi kasus panggunaan sing padha

Sadurunge wawancara pisanan, aku kudu ngrampungake masalah rekrutmen. Iku app web prasaja, aku nulis sawetara kode, Googled sawetara pitakonan Komplek, lan app wis siyap. Sajrone Interview, Recruiter takon kula kok aku nyampur kode jQuery karo JavaScript kosong ing saindhenging kode. wangsulanku? "Umm ..." Jujur, aku nempel sawetara potongan kode saka Stack Overflow. Aku ora mikir banget. Kode kasebut bisa digunakake, mula aku nerusake. Kesalahan iki umum banget ing antarane pangembang anyar. Kita fokus banget kanggo ngrampungake masalah ing pakaryan nganti ora nggatekake cara nindakake. Aja dadi salah sawijining wong anyar sing tiba ing jebakan iki. Priksa saben baris kode lan priksa manawa sampeyan ngerti kenapa sampeyan sijine ing kono.

Ambalan kode

Don't Repeat Yourself (DRY) minangka dogma pemrograman. Nggawe abstraksi kanggo kode bola-bali minangka inti saka pemrograman. Ya, bisa uga angel ing wiwitan. Yen sampeyan pengin ngatasi masalah, sampeyan nindakake kanthi cara apa wae. Banjur sampeyan pindhah menyang tugas liyane lan kode bola-bali tetep karo sampeyan. Sampeyan bisa ngilangi kebiasaan iki kanthi nggawe aturan dhewe. Saben-saben sampeyan nyaring fitur, waca kode maneh lan ndeleng apa sampeyan bisa nindakake kanggo ngganti. Elinga yen versi pisanan kode biasane salah, lan sampeyan bisa nambah. Yen sampeyan ngelingi duplikat kode, njupuk wektu kanggo sinau. Kanthi cara iki sampeyan bisa nemtokake cara paling apik kanggo nulis ulang (contone, nggunakake loop utawa nggawe fungsi anyar). Yen sampeyan nindakake reresik iki saben wektu, sampeyan bakal entuk kode sing luwih dipercaya lan elegan.

Kesalahan sing ora ditangani

Meh mokal kanggo nggawe aplikasi sing migunani sing mesthi bisa digunakake kanthi sampurna. Apa sampeyan ngisi basis data utawa nelpon API, ana kesalahan. Kesalahan sing ora ditangani ora mung bisa mungkasi fungsi individu saka mlaku, nanging bisa nyebabake kabeh aplikasi nabrak. Ngantisipasi kesalahan bisa dadi tandha saka programmer sing kompeten. Saben sampeyan ngakses utawa nganyari data eksternal, sampeyan kudu siyap kanggo skenario paling ala. Tandha masalah potensial kanthi cara sing ora nggawe aplikasi ora bisa digunakake. Iki bakal ngidini pamaca kode sampeyan (lan mbok menawa sampeyan) bisa nemokake kesalahan kanthi cepet. Iku uga bakal nuduhake recruiter sing bisa nulis kode cohesive.

Lack saka konsistensi

Konsistensi minangka ciri khas piranti lunak kualitas. Iku ndadekake kode luwih gampang kanggo maca lan njaga. Kode digawe ing gaya seragam luwih katebak, lan iku luwih gampang kanggo ngira-ngira kinerja program. Ing tingkat abstraksi sing luwih dhuwur, konsistensi angel digayuh. Perlu pirang-pirang taun kanggo nguwasani, dadi sampeyan kudu miwiti sinau teknik iki sedini mungkin. Elinga nggawe judhul nggunakake mung siji basa. Mesthine kudu basa Inggris, nanging ing proyek pribadi sampeyan bisa menehi jeneng variabel lan fungsi ing basa apa wae anggere basa kasebut tansah padha. Yen sampeyan konsisten, ora masalah yen sampeyan nggunakake tab utawa spasi. Nggawe utawa milih guide gaya lan tansah tetep. Sampeyan uga kudu nggunakake alat kaya Prettier . Iku pancene mbantu supaya kode diformat kanthi cara sing konsisten. Apa wae alat lan gaya sing sampeyan gunakake, gunakake kanthi konsisten. Malah yen sampeyan nulis kode ala ing gaya konsisten, iku biasane luwih apik tinimbang kode inconsistently apik amarga iku luwih gampang kanggo ndandani.

Salah pangerten saka piranti

Ing proyek khas, sampeyan kudu nggunakake sawetara perpustakaan eksternal. Akeh programer nginstal perpustakaan meh kanthi otomatis amarga digunakake ing saben proyek. Pustaka eksternal apik banget amarga minangka cara sing wis kabukten kanggo ngatasi masalah sing terus-terusan. Nanging, pangembang anyar asring ora ngerti perpustakaan endi sing digunakake lan pungkasane nambahake siji perpustakaan ing ndhuwur liyane utawa ngetrapake maneh sawetara fungsi sing wis ana. Saben sampeyan nginstal perpustakaan ing proyek sampeyan, waca utawa paling ora ndeleng dokumentasi. Priksa cara lan properti sing bisa digunakake lan priksa manawa sampeyan ngerti masalah sing kudu dirampungake perpustakaan lan sing mbutuhake alat sing beda. Kanthi cara iki sampeyan bisa milih alat sing tepat kanggo proyek kasebut lan nerangake pilihan sampeyan.

Carane Kontribusi kanggo Open Source Software kanggo pisanan

Source: Jamestucker.dev Ing dina liyane aku weruh tweet saka Evan Yu (ngripta Vue.js ) babagan repositori anyar sing lagi digarap lan aku kasengsem. Aku mutusaké aku wanted kanggo kontribusi kanggo! Sing nyekel yaiku aku durung nate nyumbang kanggo proyek sumber terbuka sadurunge lan ora ngerti arep miwiti saka ngendi. Nanging ora bisa dadi angel, ta? Sawise aku mlebu gudang, aku langsung beku. “Apa sing kudu tak lakoni?” batinku. Yen aku nggawe PR (panyuwunan tarik, panyuwunan gabung), spesialis bisa uga bakal nyuwek kodeku. Aku mesthi bakal dikenal ing jagad pangembangan minangka wong sing ora ngerti cara nggarap sumber terbuka kanthi bener. Lan karirku bakal mungkasi. Begjanipun, aku maca artikel (aku ora ngelingi ngendi) sing penulis menehi saran supaya kontribusi pisanan sampeyan ing repositori wong liya kudu dadi wicaksana. Iki bisa uga gampang kaya mbenerake kesalahan ketik. Lan aku iya. Aku maca dokumentasi repositori, nemokake sawetara typo, mbukak PR, lan lah, Evan nyetujoni owah-owahanku. Aku resmi dadi kontributor Vue! Mungkin aku kudu nyelehake iki ing bio Twitter?

"Iku apik, nanging carane aku miwiti?"

Oke, ayo miwiti: Aku bakal nuduhake langkah-langkah sing bisa ditindakake kanggo nggawe prabédan.

1. Golek proyek

Kanggo inspirasi, pikirake babagan teknologi utawa alat favorit sampeyan. Contone, sampeyan nggarap JavaScript lan nggunakake Gatsby ? Priksa repositori dheweke ! Sampeyan uga bisa nyumbang kanggo salah sawijining repositori. Punika dhaptar proyek frontend. Yen sampeyan duwe soko sampeyan tresna utawa golek migunani, Aku seneng sampeyan nambah! Pungkasan, Awesome First PR Opportunities minangka repositori raksasa proyek sumber terbuka kanggo pamula. Ana proyek ing 22 basa sing beda-beda!

2. Temtokake carane sampeyan bisa nyumbang

Priksa proyek kasebut. Maca Readme. Pindai folder lan file sing beda. Entuk pangerten babagan struktur basis kode. Kanthi nindakake iki, sampeyan bisa kanthi gampang nemokake lan mbenerake kesalahan ketik! Yen wis rampung, deleng bagean Masalah ing proyek kasebut. Ing kana sampeyan bakal nemokake dhaptar bug sing ditemokake sadurunge utawa fitur sing disaranake. Untunge, akeh proyek kalebu masalah sing diarahake kanggo pamula. Aku kontribusi pisanan sampeyan kudu minangka subtle sabisa, nanging yen sampeyan pengin entuk pangenalan cepet, iku nganti sampeyan. Sawise sampeyan nemokake apa sing bisa ditambahake menyang proyek kasebut, sampeyan kudu nggawe garpu.

3. Nggawe garpu proyek

Garpu (garpu proyek) nggawe salinan sing tepat ing repositori Github sampeyan dhewe.

4. Klone proyek lokal

Banjur tiron proyek menyang folder lokal nggunakake URL proyek.

git clone <project-url>

Ing kene sampeyan bakal nemokake URL. Saiki proyek kasebut ana ing komputer, bukak ing editor. Yen sampeyan mikir owah-owahan bakal mbutuhake wektu, priksa manawa sampeyan nyelarasake salinan proyek kasebut karo asline supaya sampeyan tansah ngerti owah-owahan kasebut. Sampeyan bisa nemokake prentah Git sing tepat kanggo iki ing kene .

5. Nggawe cabang anyar kanggo owah-owahan

Wektu kanggo nggawe pangowahan / koreksi! Gawe cabang anyar ing ngendi owah-owahan sampeyan bakal ditrapake.

git branch <branch-name>

Sampeyan bisa nelpon apa wae sing dikarepake, nanging ing pengalaman sampeyan bakal bisa ndeleng pola kanggo menehi jeneng cabang ing proyek asli. Ing kasus iki, aku nyaranake tindakake cithakan sing wis ana. Jeneng cabang sing apik kanggo ndandani kesalahan ketik yaiku patch/typo-fix . Sampeyan bisa ngalih menyang cabang iki nggunakake git checkout <branch-name> . Saiki gawe owah-owahan sampeyan!

6. Bukak PR (Permintaan Gabung)

Dadi sampeyan wis ndandani kesalahan ketik sing cetha utawa nganyari link sing rusak. Sampeyan bangga karo karya. Sampeyan pengin kabeh jagad ngerti yen sampeyan minangka salah sawijining pangembang mitos sing bisa menehi kode, mbusak, lan nonton Netflix bebarengan. Push owah-owahan menyang repositori Github branched nggunakake git push -u origin <branch-name> . Pindhah menyang repositori Github bercabang lan bukak PR (panyuwunan tarik). Cathetan: Yen sampeyan durung nate njaluk panjaluk, tonton video iki dening Kent Dodds kanggo sinau carane nindakake. Priksa manawa cabang sampeyan nuduhake cabang master saka gudang sumber. Saiki sampeyan siyap nambah rincian menyang PR sampeyan. Priksa manawa judhul sampeyan kanthi jelas nuduhake isi PR. Nambahake katrangan: Yen sampeyan ndandani masalah sing wis ana, priksa manawa sampeyan kalebu link kasebut. Sawise rampung karo deskripsi, kirim PR kanggo ditinjau. Sapa wae sing duwe wewenang kanggo nyetujoni PR bakal mriksa aplikasi sampeyan sajrone sawetara dina lan nindakake salah siji saka ing ngisor iki:

1. Bakal nggabungake owah-owahan langsung.
2. Bakal njaluk sampeyan nggawe owahan.
3. Bakal nutup PR sampeyan.

Sabar amarga panyipta repositori bisa uga sibuk karo proyek full-time utawa proyek liyane.

Sampeyan nindakake!

Sampeyan saiki dadi kontributor kanggo proyek open source! Piye rasane? Siap mbangun pesaing Node.js sampeyan dhewe? Muga-muga kanthi menehi sumbangan sing prasaja, prospek karya open source ing mangsa ngarep bakal dadi kurang nggegirisi. Kanggo informasi luwih lengkap babagan kontribusi open source, priksa pandhuan open source .