Proyek Open Source Kesulitan dengan Onboarding karena "Good First Issues" Gagal Membantu Kontributor Baru

Tim Komunitas BigGo
Proyek Open Source Kesulitan dengan Onboarding karena "Good First Issues" Gagal Membantu Kontributor Baru

Para maintainer open source menghadapi tantangan yang semakin besar dalam menarik kontributor baru, karena sistem good first issue yang banyak digunakan di GitHub terbukti semakin tidak efektif. Apa yang dirancang sebagai pintu masuk yang ramah bagi pendatang baru telah menjadi kuburan tugas-tugas yang ketinggalan zaman dan persyaratan yang tidak jelas, membuat calon kontributor frustasi dan proyek kekurangan tenaga.

Masalah Umum dengan " Good First Issues ":Issues yang Basi - Implementasi tidak lagi diperlukan tetapi tidak diperbarui • Issues yang Terabaikan - Pull request terhubung tetapi tidak ada respons dari maintainer
Konteks yang Ambigu - Mengasumsikan pendatang baru memahami internal proyek • Ketidakcocokan Workflow - Issues tidak mencerminkan bagaimana pengembangan sebenarnya terjadi

Krisis Onboarding dalam Open Source

Masalahnya lebih dalam dari sekadar label issue yang tidak terawat dengan baik. Diskusi komunitas mengungkapkan bahwa kontributor yang sukses jarang bergabung dengan proyek karena keinginan abstrak untuk membantu. Sebaliknya, mereka biasanya datang dengan kebutuhan spesifik - seringkali untuk menghindari pemeliharaan fork mereka sendiri atau untuk mengimplementasikan fitur yang mereka butuhkan. Ketidaksesuaian mendasar antara cara proyek mencoba menarik kontributor dan cara orang benar-benar menemukan pekerjaan open source ini menciptakan hambatan yang signifikan.

Tantangan menjadi lebih kompleks ketika mempertimbangkan bahwa first issue yang berkualitas cenderung diselesaikan dengan cepat, meninggalkan hanya tugas-tugas yang sulit atau bermasalah. Seorang anggota komunitas mencatat pentingnya sengaja meninggalkan pekerjaan berdampak rendah khusus untuk pendatang baru, mengakui bahwa perasaan pencapaian sangat penting bagi kontributor baru.

Hambatan Dokumentasi dan Setup

Selain manajemen issue, proyek menghadapi rintangan substansial dalam infrastruktur onboarding dasar. Banyak kontributor menghabiskan berhari-hari hanya untuk mencari tahu cara membangun dan menjalankan proyek secara lokal. Ini sangat menantang untuk sistem kompleks yang melibatkan beberapa repositori atau pustaka yang diatur dengan hati-hati. Kurangnya instruksi inner dev loop yang jelas dalam dokumentasi proyek menciptakan hambatan langsung yang mencegah partisipasi sebelum coding sebenarnya dimulai.

Tidak ada yang lebih menyebalkan daripada menghabiskan dua hari untuk mencari tahu cara membangun, dan setelah dibangun, cara benar-benar menginstal/menjalankan/debug-nya.

Elemen Onboarding Penting: • Instruksi build dan setup yang jelas dalam README • Pengaturan lingkungan pengembangan lokal langkah demi langkah • Prosedur debug dan testing • Gambaran arsitektur untuk proyek multi-repositori • Pemeliharaan rutin dokumentasi yang menghadap ke pendatang baru

Masalah Perhatian Personal

Onboarding yang efektif memerlukan perhatian personal yang signifikan dari maintainer - sumber daya yang tidak dimiliki oleh banyak proyek open source. Curse of knowledge mempengaruhi bahkan maintainer yang berniat baik, yang mungkin membuat issue dengan asumsi bahwa pendatang baru memahami konteks yang butuh bertahun-tahun untuk dikembangkan. Ini menciptakan siklus di mana proyek kesulitan menarik bantuan justru karena mereka membutuhkan bantuan untuk menarik kontributor secara efektif.

Solusinya memerlukan perlakuan setiap good first issue sebagai kontrak dengan pendatang baru. Maintainer harus memberikan panduan yang tepat dan membantu tanpa asumsi tentang pengetahuan sebelumnya. Namun, tingkat perhatian ini membutuhkan waktu dan energi yang seringkali tidak dapat dipenuhi oleh maintainer sukarelawan, menciptakan ketegangan mendasar dalam ekosistem open source.

Proyek yang berhasil melakukan onboarding kontributor baru cenderung berinvestasi besar dalam dokumentasi, prosedur setup yang jelas, dan pemeliharaan rutin konten yang menghadap pendatang baru. Meskipun ini merepresentasikan pekerjaan awal yang signifikan, hal ini memberikan dividen dalam membangun komunitas kontributor yang berkelanjutan yang dapat membantu memelihara dan mengembangkan proyek dari waktu ke waktu.

Referensi: Why good first issues are usually not good first issues