Buat kunjungan pertama ke repositori bermanfaat
Sebelum membagikan tautan, buka repositori seperti orang yang belum pernah mendengarnya. Layar pertama harus menjelaskan masalah, pengguna sasaran, dan cara tercepat melihat hasilnya. Tangkapan layar dapat membantu alat visual; untuk pustaka, contoh masukan/keluaran kecil sering kali lebih berguna.
Untuk validator CSV rekaan, ‘Validasi ekspor CSV sebelum mengimpornya ke basis data’ lebih informatif daripada ‘Perangkat data yang andal’. Lanjutkan dengan contoh berkas tidak valid, perintah pemeriksaan, dan kesalahan yang dihasilkan.
- Letakkan tujuan dan contoh yang berfungsi sebelum daftar fitur yang panjang.
- Cantumkan persyaratan lingkungan eksekusi, langkah instalasi, dan keterbatasan yang diketahui.
- Tautkan lisensi, dokumentasi, dan tempat melaporkan masalah.
- Gunakan topik repositori yang akurat agar orang yang menelusuri topik tersebut dapat menemukan proyek Anda.
Temukan pembaca pertama yang relevan
Pilih komunitas yang sudah membahas masalah yang Anda selesaikan. Alat data Python memerlukan pengantar berbeda dari alat desain berbasis peramban. Jelaskan satu kasus penggunaan konkret dan bagian yang ingin Anda mintai masukan. Ungkapkan bahwa Anda pengelola proyek dan baca aturan posting komunitas terlebih dahulu.
Buat eksperimen awal berskala kecil: perbaiki README, bagikan satu contoh yang dapat dijalankan di satu tempat yang sesuai, dan jawab pertanyaan yang muncul. Jika pembaca tidak dapat menginstalnya, perbaiki dahulu sebelum menambah saluran. Mengirim tautan yang sama berulang kali tidak menggantikan penyelesaian masalah saat mulai menggunakan proyek.
Mintalah bintang setelah memberikan sesuatu yang berguna
Satu kalimat singkat dan opsional setelah panduan mulai cepat sudah cukup: ‘Jika proyek ini berguna bagi Anda, beri bintang pada repositori agar mudah ditemukan lagi.’ Pastikan petunjuk instalasi, dokumentasi, dan dukungan tetap tersedia terlepas dari apakah seseorang memberi bintang.
GitHubStart menyediakan direktori publik untuk penemuan dan pertukaran proyek. Anda dapat mendaftarkan repositori publik tanpa masuk ke GitHubStart, menelusuri proyek lain, dan memilih proyek yang ingin didukung. Pemberian bintang tetap dilakukan secara manual setelah masuk ke GitHub. Mendaftarkan repositori tidak menjanjikan jumlah bintang tertentu atau bintang balasan.
Gunakan catatan pembelajaran mingguan
Catat tanggal, perubahan yang dibuat, tempat membagikannya, pertanyaan yang diterima, dan hal yang diperbaiki. Bandingkan bintang dengan sinyal praktis seperti instalasi berhasil, masalah yang dapat direproduksi, dan kontribusi berulang. Lonjakan setelah sebuah posting adalah korelasi, bukan bukti bahwa setiap bintang baru berasal dari posting tersebut.
Contoh: jika lima pembaca bertanya cara mengatur token, pindahkan petunjuk konfigurasi ke atas contoh. Bagikan contoh yang diperbaiki kepada mereka, alih-alih menerbitkan pengumuman peluncuran umum lagi.
- Minggu 1: verifikasi panduan mulai cepat dari lingkungan bersih.
- Minggu 2: bagikan satu kasus penggunaan dan tanggapi masukan.
- Minggu 3: terbitkan perbaikan dan jelaskan perubahannya.
- Minggu 4: pertahankan saluran yang menghasilkan percakapan berguna dan tinjau sisanya.
Pertanyaan umum
Bagaimana mendapatkan 100 bintang GitHub pertama?
Anggap 100 sebagai tonggak, bukan hasil yang dijanjikan. Mulailah dengan proyek yang dapat digunakan, README yang jelas, dan pembaca yang relevan. Langkah yang sama berlaku pada 5 maupun 500 bintang; waktu yang dibutuhkan bergantung pada audiens dan proyek.
Bisakah saya memberi bintang pada repositori GitHub tanpa masuk?
Anda dapat menelusuri repositori publik dan GitHubStart tanpa akun situs. Untuk memberi bintang, Anda harus masuk sendiri ke GitHub. GitHubStart tidak melakukan tindakan tersebut untuk Anda.
Apakah lebih banyak bintang berarti lebih banyak pengguna?
Belum tentu. Seseorang mungkin menyimpan repositori untuk nanti tanpa menginstalnya. Lacak adopsi dan masukan secara terpisah dari jumlah bintang.