Selamat datang! ??
Good First Issue adalah inisiatif untuk mengumpulkan hasil yang mudah dari proyek-proyek populer, sehingga pengembang yang belum pernah berkontribusi pada sumber terbuka dapat memulai dengan cepat.
Pengelola sumber terbuka selalu berupaya melibatkan lebih banyak orang, namun pengembang baru umumnya merasa sulit untuk menjadi kontributor. Kami percaya bahwa meminta pengembang untuk memperbaiki masalah yang sangat mudah akan menghilangkan hambatan untuk berkontribusi di masa depan. Inilah sebabnya Good First Issue ada.
Anda dipersilakan untuk menambahkan proyek baru di Good First Issue, dan kami mendorong semua proyek — lama dan baru, besar dan kecil.
Ikuti langkah-langkah sederhana ini:
Tujuan kami adalah mempersempit proyek untuk kontributor sumber terbuka baru. Untuk menjaga kualitas proyek di Good First Issue, pastikan repositori GitHub Anda memenuhi kriteria berikut:
Setidaknya ada tiga terbitan dengan label good first issue . Label ini sudah ada di semua repositori secara default. Jika belum, Anda bisa mengikuti langkah-langkahnya di sini.
Setidaknya memiliki 10 kontributor.
Ini berisi README.md dengan petunjuk pengaturan rinci untuk proyek, dan CONTRIBUTING.md dengan pedoman untuk kontributor baru.
Itu dipelihara secara aktif.
Tambahkan jalur repositori Anda (dalam urutan leksikografis) di data/repositories.toml.
Buat permintaan tarik baru. Silakan tambahkan tautan ke halaman terbitan repositori dalam deskripsi PR. Setelah permintaan penarikan digabungkan, perubahan akan diterapkan di goodfirstissue.dev.
Good First Issue memiliki dua komponen — aplikasi front-end yang dibuat dengan Nuxt.js dan skrip populasi data yang ditulis dengan Python.
Untuk menyumbangkan fitur dan perubahan baru pada situs web, Anda ingin menjalankan aplikasi secara lokal. Silakan ikuti langkah-langkah berikut:
Kloning proyek secara lokal. Pastikan Anda menginstal Python 3 dan Node.js versi terbaru di komputer Anda.
Buat salinan file data sampel untuk digunakan oleh aplikasi lokal Anda dan ganti namanya menjadi nama file yang diharapkan oleh aplikasi. Langkah ini penting, karena aplikasi front-end tidak akan berfungsi tanpa file data ini.
$ cp data/generated.sample.json data/generated.json $ cp data/tags.sample.json data/tags.json
Bangun aplikasi front-end dan mulai server pengembangan.
$ bun install # instal dependensi$ bun dev # mulai server pengembangan
Aplikasi ini akan terbuka di browser Anda.
