GitHub Pull Request

# Mengelola dan Mengedit Pull Request Kontributor di GitHub

Git7/7
Diterbitkan pada:
Estimasi waktu baca:7 min read
Table of Contents

Sebagai pemilik atau pengelola repositori open-source, kamu sering kali menerima Pull Request (PR) yang konsepnya bagus tetapi masih memiliki kekurangan kecil. Kekurangan tersebut bisa berupa typo nama variabel, format kode yang melenceng dari konfigurasi linter, atau tes unit yang kurang satu skenario.

Menunggu kontributor merespons review hanya untuk perbaikan satu baris kode dapat memperlambat proses rilis. Opsi yang jauh lebih cepat adalah turun tangan mengedit branch PR tersebut secara langsung tanpa menghilangkan hak atribusi kontributor asli.

Berikut panduan teknis mengelola, mengedit, dan menegakkan hak akses pada PR kontributor di GitHub.

1. Mengedit PR Kontributor Secara Langsung

GitHub memungkinkan maintainer repositori upstream untuk mengirim commit langsung ke branch milik kontributor selama izin akses diberikan.

Menggunakan GitHub CLI (gh)

Cara tercepat dan paling minim konfigurasi adalah menggunakan GitHub CLI. Perintah ini otomatis menambahkan remote fork kontributor, mengambil branch terkait, dan berpindah ke branch lokal:

Terminal window
gh pr checkout 42

Ganti 42 dengan nomor PR yang ingin kamu edit. Setelah berada di branch lokal tersebut, lakukan perbaikan kode:

Terminal window
# Lakukan perubahan file, lalu simpan ke staging
git add src/config.ts
git commit -m "fix(config): perbaiki format url endpoint"
# Kirim perubahan langsung ke branch fork kontributor
git push

Git akan otomatis mengarahkan proses push ke remote fork milik kontributor tempat PR tersebut berasal.

Menggunakan Git Standar (Tanpa gh)

Jika kamu tidak menggunakan GitHub CLI, tambahkan repositori fork kontributor sebagai remote baru secara manual:

Terminal window
# 1. Daftarkan remote fork milik kontributor
git remote add kontributor https://github.com/username-kontributor/nama-repo.git
# 2. Ambil referensi branch dari fork tersebut
git fetch kontributor nama-branch-fitur
# 3. Buat branch lokal yang melacak branch kontributor
git checkout -b review-pr-42 kontributor/nama-branch-fitur
# 4. Lakukan revisi kode dan commit
git add src/config.ts
git commit -m "fix(config): sesuaikan tipe data port"
# 5. Push commit ke branch di fork kontributor
git push kontributor HEAD:nama-branch-fitur

Alternatif lain untuk membaca kode tanpa remote tambahan adalah memanfaatkan refspec tersembunyi GitHub:

Terminal window
git fetch origin pull/42/head:pr-42
git checkout pr-42

Namun, perintah refspec di atas hanya bersifat read-only dari sisi remote origin. Untuk melakukan push balik, remote fork kontributor tetap wajib didaftarkan dengan kredensial akunmu yang memiliki hak tulis ke repositori upstream.

2. Mempertahankan Atribusi Kontributor dan Maintainer (Co-Author)

Ketika maintainer mengambil alih penyelesaian branch atau melakukan squash merge, nama kontributor tidak boleh hilang dari riwayat git. GitHub mendukung metadata co-author melalui trailer commit message standar.

Format Trailer Co-authored-by

Format trailer harus diletakkan pada bagian paling bawah commit message, dipisahkan oleh minimal satu baris kosong dari badan pesan:

feat(auth): tambahkan verifikasi token oauth2
Implementasikan validasi payload jwt dan penanganan error token expired.
Co-authored-by: Budi Santoso <[email protected]>
Co-authored-by: Dika Ardnt <[email protected]>

Aturan penulisan co-author agar dikenali oleh GitHub:

  1. Awali baris dengan tulisan persis Co-authored-by: (perhatikan tanda titik dua dan huruf kapital).
  2. Tulis nama kontributor diikuti alamat email di dalam kurung siku (<email>).
  3. Email yang digunakan harus sesuai dengan email yang terhubung ke akun GitHub kontributor agar foto profil mereka muncul di samping commit.
  4. Jangan meletakkan teks apa pun di bawah baris trailer co-author.

Membuat Commit Co-Author Lewat Terminal

Kamu bisa menyusun commit co-author langsung melalui argumen -m bertingkat:

Terminal window
git commit -m "feat(api): validasi skema payload" \
-m "Menambahkan pengecekan tipe data pada field webhook." \
-m "Co-authored-by: Budi Santoso <[email protected]>"

Mempertahankan Kredit Saat Squash Merge

Jika kamu menggabungkan PR melalui fitur Squash and merge di web UI GitHub, riwayat commit di branch PR akan dilebur menjadi satu commit tunggal di branch utama (main).

Secara default, GitHub otomatis menambahkan baris Co-authored-by untuk setiap kontributor yang memiliki commit di branch tersebut ke dalam kotak teks deskripsi merge. Pastikan kamu tidak menghapus baris trailer tersebut sebelum menekan tombol konfirmasi merge.

3. Mengatur Izin Allow edits from maintainers

Fitur Allow edits from maintainers (properti API: maintainer_can_modify) memberi hak tulis sementara kepada maintainer upstream untuk melakukan push ke branch fork kontributor.

Batasan Arsitektur GitHub

Dari sisi arsitektur otorisasi GitHub:

  • Centang izin ini berada di form pembukaan PR pada antarmuka kontributor.
  • Secara default, GitHub selalu mencentang opsi ini secara otomatis setiap kali kontributor membuat PR dari fork akun personal.
  • Maintainer repositori upstream tidak memiliki akses tombol untuk mencentang opsi ini jika kontributor sengaja mematikannya. Nilai izin ini sepenuhnya dipegang oleh pembuat PR.

Menegakkan Izin Secara Otomatis (CI Enforcement)

Karena maintainer tidak bisa mencentang opsi tersebut dari UI sendiri, cara terbaik untuk memaksa kepatuhan adalah menggunakan GitHub Actions. Workflow ini akan memvalidasi status maintainer_can_modify. Jika kontributor mematikan izin tersebut, CI akan langsung gagal dan bot memberikan komentar peringatan.

Buat file alur kerja baru di .github/workflows/pr-maintainer-edit-check.yml:

name: Check Maintainer Edit Permission
on:
pull_request_target:
types: [opened, synchronize, reopened]
jobs:
verify-permission:
runs-on: ubuntu-latest
if: github.event.pull_request.head.repo.full_name != github.repository
steps:
- name: Validasi Opsi maintainer_can_modify
env:
CAN_MODIFY: ${{ github.event.pull_request.maintainer_can_modify }}
PR_NUMBER: ${{ github.event.pull_request.number }}
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
run: |
if [ "$CAN_MODIFY" != "true" ]; then
gh pr comment "$PR_NUMBER" --body "Halo @${{ github.event.pull_request.user.login }}, repositori ini mewajibkan opsi **Allow edits from maintainers** diaktifkan agar tim maintainer dapat membantu memperbaiki kode atau menyelaraskan branch sebelum merge. Silakan centang kotak tersebut di sidebar kanan PR ini."
gh pr edit "$PR_NUMBER" --add-label "need-maintainer-access"
echo "Error: Opsi 'Allow edits from maintainers' belum dicentang oleh kontributor."
exit 1
fi
echo "Izin edit maintainer aktif."

Dengan alur kerja ini:

  1. Trigger menggunakan pull_request_target agar memiliki izin membaca context PR dari fork luar dengan aman.
  2. Kondisi github.event.pull_request.head.repo.full_name != github.repository memastikan pengecekan hanya berjalan untuk PR yang berasal dari fork, bukan branch internal repo.
  3. Status check akan berstatus merah (failing status check), sehingga aturan branch protection di branch utama (main) dapat memblokir tombol merge sampai kontributor mencentang izin tersebut.

Solusi Saat Kontributor Tidak Merespons

Jika kontributor tidak kunjung mengaktifkan izin tersebut dan perbaikan harus segera dirilis, maintainer dapat menyalin commit mereka ke branch internal baru:

Terminal window
# Ambil patch dari PR kontributor ke branch lokal baru
git checkout -b fix/salinan-pr-42 main
git pull https://github.com/username-kontributor/nama-repo.git nama-branch-fitur
# Lakukan perbaikan tambahan
git commit -am "fix: perbaiki typo konfigurasi"
# Push ke repositori upstream utama
git push origin fix/salinan-pr-42

Tutup PR lama milik kontributor dengan menyertakan tautan ke PR baru atau commit baru, dan pastikan commit tetap menyematkan atribusi Co-authored-by kontributor.

4. Mengelola Akses Maintainer Terhadap Branch Fork

Bekerja langsung pada branch milik repositori orang lain memiliki aturan dan dinamika akses yang berbeda dibanding branch internal.

Fork Personal vs Fork Organisasi

Aturan penting yang sering membingungkan maintainer:

  • Fork dari akun personal: Mendukung maintainer_can_modify. Maintainer repositori upstream otomatis diberi izin push jika opsinya aktif.
  • Fork di bawah akun Organisasi GitHub: GitHub tidak mendukung opsi Allow edits from maintainers untuk PR yang dibuat dari fork milik organisasi. Jika sebuah tim mengirim PR dari repositori organisasi mereka, maintainer upstream tidak akan pernah bisa melakukan push langsung ke branch tersebut. Perbaikan harus dikomunikasikan lewat review code atau maintainer membuat branch internal sendiri.

Masa Berlaku Hak Akses

Izin push ke branch fork bersifat sementara. Hak akses maintainer terhadap branch kontributor otomatis dicabut segera setelah PR ditutup atau selesai di-merge. Maintainer juga tidak memiliki hak akses ke branch lain atau pengaturan repositori fork milik kontributor.

Pengaruh Branch Protection di Fork

Meskipun kontributor sudah mencentang Allow edits from maintainers, maintainer tetap bisa gagal melakukan push jika kontributor mengaktifkan Branch Protection Rule pada repositorinya sendiri. Misalnya:

  • Mewajibkan signed commits (GPG/SSH sign).
  • Melarang force push.

Jika kamu mencoba menjalankan git push --force ke branch fork yang dilindungi, Git akan menolak dengan pesan error GH006: Protected branch update failed.

Praktik Aman Saat Mengedit Branch Kontributor

  1. Hindari Force Push Sembarangan: Jangan menjalankan git push --force atau melakukan rebase agresif di branch kontributor tanpa berdiskusi terlebih dahulu. Kontributor yang masih aktif bekerja di branch lokal mereka akan mengalami konflik riwayat (diverged branches).
  2. Gunakan Commit Tambahan: Tambahkan commit baru di atas commit kontributor alih-alih meng-amend commit mereka. Riwayat commit akan lebih transparan dan kontributor bisa mempelajari perbaikan yang kamu lakukan lewat git pull.
  3. Komunikasikan Perubahan di Kolom Komentar PR: Beri tahu kontributor bahwa kamu telah menambahkan commit perbaikan ke branch mereka agar mereka mengetahui status kode terbaru sebelum melanjutkan pengujian.
Dika Ardianta

Terima kasih telah membaca artikel di website ini. Jangan ragu untuk menjelajahi artikel lainnya!

About Me Follow me on Social Media


Git Series

# Cara Baik Dalam Menulis Git Commit Message

Git1/7
Diterbitkan pada:
diperbaruiDiperbarui pada:
Estimasi waktu baca:2 min read

Pesan commit Git bukan sekadar formalitas saat menyimpan perubahan kode. Riwayat commit yang terstruktur mempermudah pelacakan regresi (bisecting), mempermudah pembuatan catatan rilis otomatis…

Read

# Cara Menghapus History Commit Tertentu

Git2/7
Diterbitkan pada:
diperbaruiDiperbarui pada:
Estimasi waktu baca:2 min read

Menghapus file sensitif seperti .env, kredensial database, atau token API yang terlanjur masuk ke riwayat commit Git tidak cukup hanya dengan perintah git rm lalu membuat commit baru. Selama commit…

Read

# Cara Merge Commit Tertentu dari Repo lain

Git3/7
Diterbitkan pada:
diperbaruiDiperbarui pada:
Estimasi waktu baca:2 min read

Saat mengelola proyek dengan beberapa branch atau repositori terpisah, sering kali kita hanya membutuhkan perubahan dari satu atau beberapa commit tertentu tanpa harus menggabungkan seluruh riwayat…

Read

# Git Cheat Sheet

Git5/7
Diterbitkan pada:
diperbaruiDiperbarui pada:
Estimasi waktu baca:18 min read

Ini adalah Git Cheat Sheet berisi perintah-perintah Git yang sering digunakan, mulai dari operasi dasar sampai recovery, undo commit, menghapus commit tertentu dari history, rebase, stash, dan…

Read

# Cara Menimpa Commit Terakhir di Git

Git6/7
Diterbitkan pada:
Estimasi waktu baca:4 min read

Saat bekerja dengan Git, sering kali ada perubahan sepele yang tertinggal tepat setelah commit dibuat. Contohnya typo nama variabel, lupa menghapus baris debug, atau format file yang belum dirapikan.…

Read

Comments