verto

verto.sh

Gerbang Anda untuk kolaborasi sumber terbuka.

---

Masuklah ke dunia open-source dengan verto.sh ! Kami dengan hati-hati memilih proyek populer dengan masalah yang mudah diatasi, membuatnya sederhana bagi pengembang untuk menemukan proyek baru atau pertama untuk berkontribusi. Verto.sh lebih dari sekadar daftar - ini adalah platform. Di sinilah pemula dapat memberikan kontribusi pertama mereka, pendiri dapat membangun tim yang solid, dan pengelola dapat menemukan kontributor baru.

Komunitas open-source selalu menyambut bakat baru, tetapi memulai bisa terasa sulit. Verto.sh memudahkannya. Dengan menunjukkan kepada pendatang baru tali dan menghubungkannya dengan proyek-proyek yang membutuhkan bantuan, kami juga membantu orang-orang, tetapi seluruh gerakan sumber terbuka.

Dengan Verto.sh , ambil langkah pertama ke pengkodean kolaboratif, dan jadilah bagian dari sesuatu yang lebih besar. Kode Anda hari ini bisa menjadi awal dari sesuatu yang luar biasa di komunitas open-source.

Menambahkan proyek baru

Anda dipersilakan untuk menambahkan proyek baru di Verto.sh , cukup ikuti langkah -langkah ini:

• Untuk mempertahankan kualitas proyek di Verto.sh , pastikan repositori yang ingin Anda tambahkan memenuhi kriteria berikut:

  • Untuk repositori GitHub : Ia memiliki setidaknya tiga masalah dengan label good first issue atau label lain yang ditentukan dalam config.json (lihat labels dan akhir penyedia GitHub ).

  • Untuk repositori gitlab : ia memiliki setidaknya tiga masalah dengan label quick win atau label lain yang ditentukan dalam config.json (lihat labels dan akhir penyedia GitLab ).

  • Ini memiliki setidaknya 10 kontributor.

  • Ini memiliki setidaknya 1000 bintang.

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

  • Ini secara aktif dipertahankan (pembaruan terakhir kurang dari 1 bulan yang lalu).

• Untuk repositori GitHub : Tambahkan jalur repositori Anda (dalam format owner/name dan urutan leksikografi) ke config.json di dalam penyedia GitHub .

• Untuk repositori gitlab : Tambahkan ID repositori Anda (dalam format <project path>|<project id> ) ke config.json di dalam penyedia GitLab .

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

Bagaimana cara kerjanya?

Verto.sh menggunakan Next.js, React and TypeScript. Data yang ditampilkan di situs web dimuat dari file data.json, yang dihasilkan oleh fungsi di data/utils.ts. Ini menanyakan API GitHub dan Gitlab untuk mengambil masalah dari repositori yang tercantum dalam config.json. Label yang ditentukan dalam config.json digunakan untuk memfilter masalah untuk repositori.

Cara mengatur proyek secara lokal

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

1. Fork The Repository, klon secara lokal, buat cabang baru untuk mengerjakan fitur tertentu atau perbaikan bug tanpa mempengaruhi cabang utama repositori. Pastikan Anda memiliki versi terbaru dari Node.js yang diinstal di komputer Anda.
2. Anda dapat menggunakan data.json yang disertakan sebagai data dummy atau Anda dapat menjalankan npm run prebuild untuk mengambil data terbaru dari Github sendiri: untuk ini, Anda perlu mengatur variabel lingkungan GH_PAT ke Token Akses Pribadi GitHub (PAT) yang valid. PEMBERITAHUAN: Repositori Tidak Maching Kriteria yang tercantum di atas (lihat aturan dalam data.jsonare secara otomatis dihapus dari config.json ketika skrip [data.json] data/data.json) berjalan.
3. Mulai server pengembangan dan buka aplikasi di browser Anda.

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

Bagus untuk diketahui kapan Anda berkomitmen: Proyek berisi kait pre-commit yang menjalankan linters secara otomatis untuk memastikan kualitas kode!