Spesifikasi

Contoh bagaimana menggunakan tabel spesifikasi semua kontributor dapat mengenali semua kontributor

Wajib

Proyek sumber terbuka harus menyertakan item wajib berikut ini untuk mendukung spesifikasi Semua Kontributor:

1. Bagian “Kontributor” di situs terkemuka dari dokumentasi repositori proyek yang menyertakan daftar semua kontributor proyek
   • Tujuannya adalah menggunakan situs dokumentasi proyek yang paling menonjol jika memungkinkan. In many cases, this is the project README.md file
   • Consider using a CONTRIBUTORS file in the top level of the repository when the number of project contributors exceeds a level at which it is unfeasible to use the README file to acknowledge contributions. Dalam hal ini, tautan utama ke file CONTRIBUTORS harus dimasukkan pada halaman README di bawah tajuk “Kontributor”
2. Daftar harus diformat sebagai tabel dengan informasi berikut tentang kontributor proyek:
   • Nama
   • Tautan URL ke situs tempat lebih banyak informasi dapat dipelajari tentang kontributor. URL ini dapat ditentukan oleh kontributor atas kebijaksanaan proyek.
   • Indikasi Kategori Kontribusi dalam format gambar teks atau ikon menggunakan Kategori Kontribusi dan / atau gambar emoji Kategori yang ditentukan (lihat di bawah).
   • A link to the Contribution Category in text or emoji format using the defined Contribution Categories and/or Contribution Categories emoji.
     • Daftar kontributor dapat disebarkan di beberapa baris (masing-masing secara teknis menjadi tabelnya) sesuai kebutuhan.
     • Urutan kontributor tidak material terhadap spesifikasi. Urutlah sesuai keinginan kamu.
3. Proyek harus mendefinisikan kontributor sebagai mereka yang berkontribusi pada proyek di salah satu Kategori Kontribusi di setiap tingkat kontribusi. Spesifikasi ini, menurut definisi, termasuk semua kontribusi. Dalam kasus-kasus di mana proyek menyimpang dari Kategori Kontribusi atau memerlukan tingkat kontribusi tertentu untuk memenuhi kriteria sebagai kontributor proyek, proyek harus menyediakan dokumentasi eksplisit tentang definisi yang memenuhi kriteria kontributor proyek dalam dokumen BERKONTRIBUSI atau dokumen publik yang serupa yang berada di tingkat paling atas dalam repositori proyek. Spesifikasi ini merekomendasikan terhadap pengecualian individu dari daftar Kontributor berdasarkan tingkat kontribusi yang dirasakan. Sebagai gantinya, proyek harus menggunakan indikator upaya dalam daftar yang tetap mencakup semua kontributor proyek pada setiap tingkat upaya. Jika digunakan, indikator upaya ini adalah kebijaksanaan proyek dan saat ini tidak ditentukan.

Tips

You can use the @all-contributors bot 🤖 to automate acknowledging contributors to your open source projects ✨

Opsional

Proyek harus mempertimbangkan item opsional berikut sebagai bagian dari komitmen mereka terhadap spesifikasi Semua Kontributor:

1. Avatar pengguna dapat dimasukkan dan direkomendasikan.
2. Tautan opsional dari indikator Kategori Kontribusi ke kontribusi spesifik kategori dapat dimasukkan untuk memberikan informasi tambahan tentang kontribusi proyek sebagaimana dirinci dalam bagian di bawah ini.