first issues

Selamat datang! ?

Masalah pertama adalah inisiatif untuk membuat pengambilan yang mudah dari proyek open-source, sehingga pengembang yang tidak pernah berkontribusi pada sumber terbuka dapat dimulai dengan cepat.

Pemelihara open-source selalu mencari untuk melibatkan lebih banyak orang, tetapi pengembang baru umumnya berpikir itu sulit menjadi kontributor. Kami percaya membuat pengembang memperbaiki masalah yang sangat mudah menghilangkan penghalang untuk kontribusi di masa depan. Inilah sebabnya mengapa masalah pertama ada.

Menambahkan proyek baru

Anda dipersilakan untuk menambahkan proyek baru di firstissues.dev, 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 mempertahankan kualitas proyek dalam edisi pertama, pastikan repositori GitHub Anda memenuhi kriteria berikut:

  • Ini memiliki setidaknya tiga masalah dengan label good first issue . Label ini sudah ada di semua repositori secara default. Jika tidak, Anda dapat mengikuti langkah -langkah di sini.

  • Ini memiliki setidaknya 10 kontributor.

  • Ini berisi readme.md dengan instruksi pengaturan terperinci untuk proyek, dan kontribusi.MD dengan pedoman untuk kontributor baru.

  • Itu dipertahankan secara aktif.

• Tambahkan jalur repositori Anda (dalam urutan leksikografi) di data/repos.json.

• Buat permintaan tarik baru. Harap tambahkan tautan ke halaman masalah repositori dalam deskripsi PR. Setelah permintaan tarik digabungkan, perubahan akan langsung di firstissues.dev.

Menyiapkan proyek secara lokal

Firstissues dibangun menggunakan NextJS.

Untuk menyumbangkan fitur baru dan perubahan pada situs web, Anda ingin menjalankan aplikasi secara lokal. Silakan ikuti langkah -langkah ini:

1. Klon proyek secara lokal. Pastikan Anda memiliki Python 3 dan versi terbaru dari Node.js yang diinstal di komputer Anda.

2. Tambahkan github_token, mongodb_uri di file .env (rujuk .env.local untuk referensi)

3. Bangun aplikasi front-end dan mulai server pengembangan.

$ npm install # install the dependencies
$ npm run dev # start the development server

Aplikasi harus berputar di browser Anda.

Penyemaian

Setelah menyelesaikan langkah -langkah di atas, aplikasi Anda akan berjalan dan berjalan. Tapi, basis data Anda kosong. Itu perlu diisi.

 GET http://localhost:3000/api/cron

Jalankan titik akhir ini dari aplikasi pos / browser. Ini akan memakan waktu. Ini akan mengisi DB Anda dengan data penting untuk memulai.