Repository ini adalah repo untuk belajar Pull Request bagi para pengembang, untuk dapat mengelola repo dengan banyak kolaborator. Repo ini dibuat karena adanya acara tahunan Hacktoberfest 2019. Melalui repo ini, anda akan belajar untuk melakukan Pull Request dengan menambahkan nama dan link profil Github anda di file CONTRIBUTORS.md.
Menurut halaman Github di sini (Halaman dibuka 27 September 2019), Pull Request atau PR adalah suatu metode untuk memberi tahu yang lain bahwa ada perubahan yang dipush ke suatu branch di dalam repository Github. Ketika PR telah dibuka, anda dapat mendiskusikan dan mengulas berbagai perubahan dengan para kolaborator dan menambah commit-commit tambahan sebelum perubahanmu dimerge ke dalam branch utama.
Kita ambil contoh kasus berikut: Anda melihat proyek di Github yang potensial. Namun, ada flow yang sekiranya kurang efektif dan anda mampu membetulkannya. Sayangnya, anda tidak mempunyai akses write ke repository tersebut, karena anda maupun dia tidak mengenal satu sama lain.
Anda dapat membetulkan flow yang kurang efektif, lalu melakukan PR ke pemilik repository. Pemilik repository kemudian mendapatkan notifikasi ada yang melakukan PR ke repository miliknya. Ternyata, pemilik repository setuju dengan perubahan anda, dan perubahan yang anda PR dimerge ke dalam repository miliknya.
Kolaborator senang karena dibantu dengan PR anda dan anda juga senang nama anda terpampang di bagian contributors mereka (apalagi kalau PR ke proyek besar, semakin bangga pasti). Win-win solution indeed, right? :)
Kontribusi yang anda lakukan sangat simpel, yaitu menambahkan nama anda dan link profil Github anda di file CONTRIBUTORS.md, lalu melakukan PR ke repo ini. Namun, kontribusi yang anda berikan juga dapat berupa bentuk lain, seperti memperbaiki README ini misalnya atau mungkin menambahkan gambar supaya lebih indah dilihat.
PR dapat dilakukan dengan mengikuti langkah-langkah sebagai berikut:
- Fork repository ini (klik tombol di pojok kanan atas)
- Setelah proses fork selesai, lakukan:
# Kode ini dilakukan di terminal Linux atau OSX
# Mungkin ada yang bisa menambahkan untuk Windows?
# Clone repository yang sudah di fork
git clone <link repository yang sudah difork>
# Pindah ke directory belajar-pull-request
cd belajar-pull-request
- Ubah file sesuai dengan keperluan anda
- Commit file yang tadi sudah diubah dengan cara
git commit . -m 'isi pesan commit'
- Push ke repository anda dengan cara:
# Push ke repository anda
git push origin master
- Buka halaman repository ini, lalu tekan tombol Create Pull Request
- Cek kembali apakah ada conflict antara apa yang anda push dan yang ada di repository sekarang. Apabila ada, anda harus kembali ke terminal dan melakukan
git pull origin masterdi terminal anda, lalu push kembali. - Jika tidak ada conflict, tekan tombol Create Pull Request
- Setelah anda melakukan PR, PR yang anda lakukan akan direview oleh pemilik repository yaitu saya. Apabila sesuai, akan saya merge.
- Selesai!
Apabila anda punya pertanyaan, saya akan berusaha menjawab pertanyaan anda di Twitter (@dennypradipta_) karena akhir-akhir ini mulai aktif Twitter lagi.
Happy hacking!