Edit

Spesifikasi

Contoh bagaimana menggunakan tabel spesifikasi semua kontributor dapat mengenali semua kontributor

Screenshot Tabel Kontributor

Wajib

Open source projects should include the following mandatory items to support the All Contributors specification:

  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. Dalam banyak kasus, ini adalah file README pada proyek
    • 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).
    • Tautan ke Kategori Kontribusi dalam format teks atau emoji menggunakan Kategori Kontribusi yang ditentukan dan / atau Kategori Kontribusi emoji.
      • The list of contributors can be spread across multiple lines (each technically being its table) as needed.
      • 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. In cases where projects deviate from the Contribution Categories or require a specific contribution level to meet criteria as a project contributor, the project should provide explicit documentation of the definitions that satisfy the project contributor criteria in the CONTRIBUTING document or a similar prominent public document at the top level of the project repository. 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.

Kiat pro: Kamu bisa menggunakan bot @all-contributors 🤖 untuk mengotomatiskan kontributor yang mengakui proyek open source kamu ✨

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.

Apa selanjutnya

← IkhtisarKunci Emoji ✨ →