Bagaimana cara saya melibatkan para pengguna yang membintangi proyek saya di GitHub?

19

Baru-baru ini saya membuat sebuah proyek, yang disebut Hebel , yang telah saya kerjakan untuk GitHub. Ini merupakan kerangka kerja untuk pembelajaran akselerasi terdalam GPU yang ditulis dalam Python dan Nvidia CUDA. Saya memposting tentang itu di Google+ dan segera setelah itu diambil di Hacker News dan menjadi sedikit viral selama beberapa hari. Saya kemudian memposting lagi di subreddit Machine Learning dan sekaligus proyek saya mengambil 822 bintang dan 47 fork di GitHub, yang benar-benar menggembirakan. 822 bintang berarti proyek saya ada di 200 proyek Python teratas di GitHub dan bahkan memiliki lebih banyak bintang daripada beberapa proyek Python profil tinggi dan banyak digunakan seperti virtualenv.

Terlepas dari minat yang besar untuk proyek saya, saya sangat kecewa dengan keterlibatan yang sebenarnya yang saya lihat sejauh ini. Tak satu pun dari 47 percabangan proyek saya yang pernah memiliki komitmen, saya belum menerima permintaan penarikan, dan hanya tiga masalah yang diajukan diajukan oleh dua orang. Tampaknya proyek saya berpotensi sangat menarik bagi banyak orang, tetapi mereka hanya membintangi atau memotongnya sekali dan kemudian tidak pernah kembali lagi atau menggunakannya secara terus menerus.

Bagaimana saya dapat meningkatkan keterlibatan agar pengguna mengirimkan bug atau permintaan peningkatan atau meminta kontributor mengirimkan perubahan?

samudera
sumber
5
Ini adalah jenis proyek yang akan dianggap keren, tetapi tidak akan digunakan sendiri.
CodesInChaos
1
Saya kira sebagian besar orang membintangi proyek Anda sebagai bookmark karena ketika membaca readme.md, mereka membaca beberapa kata kunci (Python, CUDA) yang terdengar bagus untuk dimainkan pada tahap selanjutnya. Saya seorang pengembang perangkat lunak senior, tetapi bahkan setelah melihat halaman proyek github Anda selama beberapa menit, saya hanya memiliki gagasan yang kabur tentang apa semua ini. Jika Anda ingin orang berkontribusi pada proyek Anda, saran saya - benar-benar tidak ilmiah - akan disajikan dengan cara yang seseorang yang tidak tahu banyak tentang jaringan saraf (dan semua hal ahli lainnya) juga bisa mengerti.
ssc

Jawaban:

25

Anda telah bekerja sangat keras dalam hal ini. Selamat atas semua perhatian, tapi maaf itu tidak menarik.

Hal pertama yang saya perhatikan adalah tidak ada masalah. Untuk membuat orang terlibat, Anda harus terlihat di umpan berita GitHub mereka. Ketika Anda memulai suatu masalah, itu akan muncul untuk orang-orang yang mengikuti proyek (bukan yang membintanginya). Jadi ukuran komunitas Anda sebenarnya sekitar 80 pengikut. Hanya pengikut yang harus Anda pikirkan. Forker hanya dapat mengambil kode dan berjalan pergi, dan bintang-bintang adalah semacam bookmark. Seorang pengikut akan mendapat pemberitahuan tentang masalah baru.

Coba buka beberapa masalah mudah.

EDIT:

README.md Anda adalah iklan repo. Ini adalah hal pertama yang orang akan baca, dan hal pertama yang mereka minta bantuan. 2/3 dari readme Anda berbicara tentang apa bahasa Hebel dalam bahasa yang secara teknis spesifik (yaitu saya tidak tahu apa yang Anda bicarakan). 1/3 bawah hanya memiliki beberapa instruksi instalasi.

Salah satu hal paling sulit yang saya temukan dengan GitHub adalah mendapatkan proyek untuk benar-benar melakukan apa yang diklaim penulis. Memasang, menjalankan, dan mulai bekerja membutuhkan waktu paling banyak. Jika seseorang mendapatkan repo Anda tetapi tidak berhasil, maka Anda tidak akan pernah mendapatkan permintaan tarik.

Saya hanya bisa curiga bahwa inilah penyebabnya.

Merevisi readme Anda, dan letakkan instruksi memulai / pemasangan tepat di atas. Jadi orang-orang bisa langsung masuk dan pergi.

Kedua, sertakan beberapa contoh / contoh yang bisa mereka jalankan dengan cepat yang menunjukkan manfaat proyek.

Reactgular
sumber
3
Tanpa keraguan. Jika Anda memiliki bagian dalam README yang terlihat seperti "Berkontribusi: mengkloning repo, jalankan skrip pembuatan satu baris ini, tambahkan fitur, tambahkan tes, kirim PR" maka saya pikir Anda akan membuat banyak kemajuan. Ada banyak inersia yang melompat ke proyek orang lain. Buat itu mudah bagi mereka!
Daniel J. Pritchett