Pernahkah Anda menemukan paket di GitHub yang Anda sukai, tetapi ingin menambahkan fitur cepat, memperbaiki bug yang Anda temukan, atau mungkin hanya berkontribusi pada open source secara keseluruhan? Bergabunglah dengan tren coding sosial, bagikan keahlian Anda, dan bantu manfaatkan dunia open source. Di artikel ini, pelajari semua tentang cara menyumbangkan kode ke repositori di GitHub, atau layanan git yang dihosting.
Dapatkan Penyiapan
Artikel ini mengasumsikan Anda sudah memiliki akun GitHub, tetapi jika belum, harap cepat daftar untuk mendapatkan akun gratis. Juga, pastikan Anda sudah memilikinya git diinstal dengan menjalankan perintah berikut di terminal:
git --version
Jika alih-alih melihat nomor versi Anda mendapatkan pesan "perintah tidak ditemukan", Anda dapat menginstal git dengan perintah:
sudo apt-get -y install git
Garpu Repositori
Pertama, Anda harus memilih repositori yang ingin Anda kontribusikan, dan mengunjunginya di browser web Anda. Jika Anda tidak yakin repositori mana yang harus dipilih, Anda dapat menggunakan repositori demo yang terletak di
https://github.com/mdizak/muo_demo. Ini adalah demo sederhana, dan Anda dipersilakan untuk membuat permintaan tarik terhadapnya untuk tujuan pengujian dan pembelajaran.Saat melihat repositori di browser web Anda, cari file Repositori Garpu tombol, dan klik. Ini akan membagi repositori ke akun GitHub Anda sendiri, dan membawa Anda ke sana. Selanjutnya Anda perlu mengkloning repositori bercabang baru, jadi buka terminal di komputer lokal Anda dan jalankan:
Ingin memahami perangkat lunak di GitHub? Berikut cara membuatnya menjadi timur dengan alat GitHub Desktop yang efisien.
git clone https://github.com/myusername/muo_demo.git
cd muo_demo
Biasanya, pastikan Anda mengubah URL di atas ke yang ada pada repositori bercabang Anda yang baru. Setelah di-clone, tambahkan repositori asli sebagai upstream dengan perintah:
git remote tambahkan upstream https://github.com/mdizak/muo_demo.git
Pastikan untuk mengubah URL pada perintah di atas dengan yang dari repositori asli yang Anda kloning. Ini menandakan kepada git bahwa itu adalah repositori induk tempat Anda bekerja.
Siapkan Repositori Lokal
Setiap kali sebelum Anda mulai mengerjakan kontribusi baru, pastikan Anda menjalankan basis kode terbaru dari repositori induk. Di dalam direktori proyek, jalankan perintah berikut di terminal:
git checkout master
git pull master hulu && git push origin master
Perintah pertama memastikan Anda saat ini bekerja di cabang master, dan perintah kedua menyinkronkan repositori induk dengan repositori lokal dan GitHub Anda. Ini memastikan Anda memodifikasi basis kode terbaru, dan tidak bekerja dengan kode yang sudah ketinggalan zaman.
Juga pastikan untuk memeriksa apakah proyek tersebut memiliki file kontribusi.md, dan jika demikian, pastikan untuk mengikuti apa yang dikatakannya. Terkadang proyek memiliki pedoman khusus tentang bagaimana memberikan kontribusi, yang harus selalu diikuti.
Buat Cabang Baru
Anda perlu membuat cabang baru yang akan menampung semua modifikasi untuk kontribusi ini, yang nantinya akan digabungkan ke dalam repositori GitHub utama oleh pengelola proyek. Cabang harus alfanumerik, dan dapat diberi nama apapun yang Anda inginkan.
Meskipun tidak wajib, umumnya dianggap kesopanan umum untuk mengawali nama cabang dengan perbaikan terbaru / untuk perbaikan bug cepat atau fitur / untuk fitur tambahan. Pilih nama cabang yang Anda inginkan, dan jalankan perintah:
git checkout -b feature / my_cool_feature
Anda harus selalu membuat cabang terpisah untuk setiap perbaikan fitur / bug, dan jangan pernah menyertakan banyak kontribusi dalam satu. Ini membantu menjaga kelancaran aliran pengembangan, dan juga membantu memastikan kontribusi Anda diterima dan disertakan dalam proyek.
Sekarang cabang Anda telah dibuat, lanjutkan dan selesaikan setiap modifikasi yang Anda inginkan dengan alur kerja git standar.
Berkomitmen dan Buat Permintaan Tarik
Setelah Anda menyelesaikan pekerjaan atas kontribusi Anda, lakukan dengan a pesan komit yang tepat dan dorong ke repositori bercabang Anda dengan perintah:
git commit --file commit.txt
git push -u fitur asal / my_cool_feature
Langkah terakhir adalah membuat permintaan tarik yang memberi tahu pengelola proyek bahwa ada kontribusi baru yang tertunda. Kunjungi repositori GitHub bercabang di browser web Anda, dan Anda akan melihat tombol tarik-turun yang memungkinkan Anda untuk mengubah cabang. Ubah ke cabang yang baru Anda buat, dan halaman berikutnya akan berisi tautan yang memungkinkan Anda membuat permintaan tarik baru.
Setelah mengklik link tersebut, Anda akan melihat halaman yang menampilkan pesan komit Anda, dan semua perubahan yang telah Anda buat di dalam kode. Tinjau semuanya untuk memastikannya benar, tambahkan pesan tambahan yang diperlukan untuk pengelola, dan kirimkan permintaan penarikan.
Terus Berkontribusi ke GitHub
Selamat, Anda telah berhasil mengirimkan kontribusi ke proyek GitHub!
Permintaan penarikan Anda sekarang menunggu peninjauan dan persetujuan oleh pengelola proyek, dan Anda akan diberi tahu melalui email apakah itu disetujui atau tidak, dan dengan pesan apa pun yang mereka miliki untuk Anda. Sekarang setelah Anda mempelajari cara berkontribusi pada proyek di GitHub, teruslah melangkah maju, dan bantu kembangkan komunitas open source.
Jika ponsel atau tablet Android Anda berjalan agak lambat, ini mungkin hanya membutuhkan sedikit lebih banyak RAM. Kami dapat membantu dengan itu.
- Pemrograman
- GitHub
Berlangganan newsletter kami
Bergabunglah dengan buletin kami untuk mendapatkan tip teknologi, ulasan, ebook gratis, dan penawaran eksklusif!
Satu langkah lagi…!
Harap konfirmasi alamat email Anda di email yang baru saja kami kirimkan kepada Anda.