Pull request (PR) adalah fitur GitHub yang memungkinkan Anda mengusulkan perubahan ke repositori yang akses tulisnya tidak Anda miliki. Pengelola repositori dapat meninjau perubahan ini dan, jika mau, menggabungkannya ke dalam repositori asli.
Membuka pull request di GitHub sangat penting dalam berkontribusi pada proyek sumber terbuka dan berkolaborasi dengan pengembang lain. Pelajari cara membuat dan membuka pull request di GitHub hanya dalam beberapa langkah mudah.
Langkah 1: Forking Repositori
Forking repositori aktif platform GitHub membuat salinan—atau dikenal sebagai "garpu"—dari repositori itu, di bawah akun Anda. Forking repositori memungkinkan Anda untuk membuat perubahan pada kode tanpa mempengaruhi repositori asli.
Untuk melakukan fork pada repositori, arahkan ke halaman utamanya dan klik garpu tombol di pojok kanan atas:
Isi nama repositori (garpu) dan deskripsi opsional dan klik Buat garpu:
Sekarang Anda telah membuat salinan dari repositori asli. Repositori baru ini memiliki koneksi dengan yang asli sehingga setiap perubahan yang Anda buat pada kode dapat dengan mudah dibandingkan dan digabungkan kembali ke dalamnya.
Langkah 2: Membuat Perubahan pada Kode
Setelah Anda mem-fork repositori, Anda mungkin perlu mengkloningnya ke mesin lokal Anda, tergantung pada jumlah dan sifat perubahan yang ingin Anda usulkan. Jika Anda membuat perubahan yang sangat sederhana yang tidak perlu Anda uji, Anda dapat melakukannya secara online menggunakan editor berbasis web GitHub.
Untuk mengkloning repositori ke mesin lokal Anda menggunakan Git, jalankan perintah terminal ini:
git klon
Mengganti dengan URL repositori Anda—Anda dapat menemukannya di GitHub. Perintah ini akan mengkloning repositori ke mesin lokal Anda, tempat Anda dapat dengan bebas bereksperimen dan membuat perubahan pada kode.
Anda harus menjaga agar perubahan tetap kecil dan terfokus, karena permintaan penarikan yang besar dapat menjadi tantangan untuk ditinjau dan digabungkan. Usahakan agar perubahan Anda tetap spesifik untuk satu masalah atau fitur, untuk memudahkan pengelola meninjau dan menerimanya.
Setelah membuat perubahan yang Anda inginkan secara lokal, komit dan dorong ke garpu GitHub Anda menggunakan Git.
Langkah 3: Membuka Permintaan Tarik
Setelah Anda melakukan perubahan ke GitHub, Anda akan melihat prompt yang mengingatkan Anda bahwa cabang Anda adalah sejumlah "komit" sebelum repositori tempat Anda melakukan forking, misalnya:
Klik Menyumbang tarik-turun. Mengklik tombol ini akan meminta Anda untuk membuka permintaan penarikan. Kemudian, klik Buka permintaan penarikan tombol:
Beberapa repositori memiliki pedoman kontribusi khusus, yang biasanya dapat Anda temukan di file CONTRIBUTING.md, yang perlu Anda ikuti. Pastikan untuk membaca dan mengikuti panduan ini sebelum Anda mengirimkan pull request.
Selanjutnya, isi bidang yang diperlukan dan klik pada Buat permintaan tarik tombol:
Pesan komit Anda harus jelas dan ringkas, menjelaskan perubahan yang Anda buat dan alasan di baliknya. Ini akan membantu pengelola memahami perubahan Anda dan mempermudah mereka meninjau kode.
Setelah Anda membuat tarikan, Anda harus menunggu pengelola proyek meninjau dan menggabungkan atau menutupnya. Pengelola mungkin memiliki saran atau umpan balik tentang permintaan penarikan Anda. Bersikaplah terbuka terhadap perubahan dan bersedia melakukan revisi jika diminta.
Pentingnya Permintaan Tarik
Permintaan tarik memfasilitasi kolaborasi antara pengembang dengan memungkinkan mereka mengusulkan perubahan, memberikan umpan balik, dan meninjau kode. Ini membantu menumbuhkan rasa kebersamaan dan kolaborasi dalam proyek, yang mengarah pada lebih banyak kontribusi dan pengembangan yang lebih cepat.
Selain itu, pull request mengatur sejarah dan pembuatan versi proyek dengan mengizinkan pengelola untuk melacak berbagai versi kode dan perubahan yang dilakukan pada setiap versi.
