Memproses permintaan pull

Setelah Anda membuka permintaan pull (PR), PR menjalani serangkaian pemeriksaan dan tinjauan untuk memastikan perubahan yang Anda usulkan dapat digabungkan. Untuk latar belakang selengkapnya tentang PR, lihat Dasar-dasar Git dan GitHub.

Validasi

Sebelum PR Anda dapat digabungkan ke cabang tujuannya, mungkin diperlukan untuk melewati satu atau beberapa proses validasi PR. Setelah Anda memilih Buat permintaan pull, GitHub menjalankan validasi yang dikonfigurasi untuk repositori Anda. Ketika proses validasi selesai, hasilnya muncul di PR.

Proses validasi bervariasi tergantung pada cakupan perubahan yang diusulkan dan aturan repositori tujuan. Setelah mengirimkan PR, Anda dapat mengharapkan satu atau beberapa hal berikut ini terjadi:

• Mergeability: Pengujian mergeabilitas GitHub garis besar terjadi terlebih dahulu untuk memverifikasi apakah perubahan yang diusulkan dalam cabang Anda bertentangan dengan cabang tujuan. Jika PR menunjukkan pengujian ini gagal, Anda harus mendamaikan konten yang menyebabkan konflik penggabungan sebelum pemrosesan dapat dilanjutkan.
• Perjanjian Lisensi Kontribusi (CLA): Sebagai kontributor non-Microsoft, jika Anda berkontribusi pada repositori publik, Anda mungkin diminta untuk menyelesaikan CLA singkat saat pertama kali mengirimkan PR ke repositori tersebut. Setelah langkah CLA dibersihkan, PR Anda diproses.
• Pelabelan: Label secara otomatis diterapkan ke PR Anda untuk menunjukkan status PR Anda saat melewati alur kerja validasi. Misalnya, PR baru mungkin secara otomatis menerima label "jangan-gabungkan", yang menunjukkan bahwa PR belum menyelesaikan langkah-langkah validasi, tinjau, dan sign-off.
• Validasi dan build: Pemeriksaan otomatis memverifikasi apakah perubahan Anda lulus pengujian validasi. Pengujian validasi mungkin menghasilkan peringatan atau kesalahan, mengharuskan Anda mengedit satu atau beberapa file di PR Anda sebelum dapat digabungkan. Hasil pengujian validasi ditambahkan sebagai komentar di PR Anda untuk ditinjau, dan hasilnya mungkin dikirimkan kepada Anda melalui email.
• Penahapan: Setelah validasi dan build berhasil, artikel yang Anda ubah secara otomatis disebarkan ke lingkungan penahapan untuk ditinjau. URL pratinjau muncul dalam komentar PR.
• Penggabungan otomatis: PR mungkin digabungkan secara otomatis jika lulus pengujian validasi dan kriteria tertentu. Dalam hal ini, Anda tidak perlu melakukan hal lain.

Umpan balik tinjauan dan alamat

Setelah semua pemrosesan PR selesai, Anda harus meninjau hasilnya (misalnya, komentar PR, hasil build). Tentukan apakah Anda perlu membuat lebih banyak perubahan sebelum mendaftar untuk penggabungan. Anda mungkin perlu mengubah konten Anda karena salah satu alasan berikut:

• Komentar PR dari peninjau. Jika peninjau PR telah meninjau PR Anda, mereka dapat memberikan umpan balik melalui komentar jika ada masalah atau pertanyaan yang luar biasa untuk diselesaikan sebelum digabungkan.
• Umpan balik dari peninjau serekan.
• Perbaikan pemformatan karena masalah penyajian.
• Kesalahan atau peringatan validasi.
• Konflik penggabungan.

Jika perlu membuat perubahan, Anda dapat mengedit konten langsung di PR, atau Anda dapat kembali ke Visual Studio Code untuk membuat perubahan. Setelah selesai, terapkan perubahan Anda ke cabang kerja Anda. PR secara otomatis diperbarui dengan perubahan Anda.

Setiap kali Anda menambahkan penerapan ke cabang kerja yang sama, penerapan ditambahkan secara otomatis ke PR. Dengan setiap penerapan, sistem penerbitan menjalankan ulang proses validasi dan peninjauan secara otomatis.

Otomatisasi masuk dan komentar

Ketika Anda telah mengatasi semua kesalahan umpan balik dan validasi, dan Anda siap untuk perubahan Anda digabungkan, saatnya untuk menandatangani PR Anda dengan membuat komentar baru yang berbunyi #sign-off. Anda harus memasukkan #sign-off komentar untuk menggabungkan perubahan Anda. Bahkan jika semua ulasan dan pemeriksaan validasi lulus, Anda bertanggung jawab untuk menggunakan komentar ini untuk memberi tahu peninjau PR dan admin repositori bahwa perubahan Anda siap untuk digabungkan.

Ketika peninjau menentukan bahwa PR Anda bebas masalah dan ditandatangani, perubahan Anda digabungkan ke cabang default dan PR ditutup.

Otomatisasi komentar memungkinkan pengguna yang tidak memiliki izin tulis dalam repositori untuk menyelesaikan tindakan tingkat tulis dengan menetapkan label yang sesuai ke PR. Jika Anda bekerja di repositori tempat otomatisasi komentar telah diterapkan, gunakan komentar hashtag yang tercantum dalam tabel berikut untuk menetapkan label, mengubah label, atau menutup PR. Penulis Microsoft juga akan diberi tahu melalui email untuk ditinjau dan ditandatangani setiap kali perubahan diusulkan ke artikel mereka.

Komentar hashtag	Apa fungsinya
#sign-off	Secara otomatis menetapkan label siap-untuk-gabung untuk memberi tahu peninjau dalam repositori bahwa PR siap untuk ditinjau/digabungkan. Jika Anda bukan penulis yang terdaftar dan mencoba menandatangani PR repositori publik menggunakan #sign-off komentar, PR diperbarui untuk menunjukkan bahwa hanya penulis yang dapat menetapkan label.
#hold-off	Menghapus label siap-untuk-gabung jika Anda berubah pikiran atau membuat kesalahan. Dalam repositori privat, ini menetapkan label jangan-gabungkan .
#please-close	Menutup PR jika Anda memutuskan untuk tidak menggabungkan perubahan.
#please-open	Membuka kembali PR atau masalah tertutup.

Memublikasikan

PR Anda harus digabungkan oleh peninjau PR sebelum perubahan dapat disertakan dalam eksekusi penerbitan terjadwal berikutnya. Biasanya, PR ditinjau dan digabungkan dalam urutan pengiriman.

Setelah kontribusi Anda disetujui dan digabungkan, proses penerbitan akan mengambilnya. Bergantung pada tim yang mengelola repositori yang Anda kontribusikan, waktu penerbitan dapat bervariasi, tetapi biasanya terjadi setidaknya sekali setiap hari kerja. Dibutuhkan waktu hingga 45 menit agar artikel muncul secara online setelah penerbitan.

Setelah perubahan Anda diterbitkan, perubahan tersebut akan ditayangkan di Microsoft Learn bagi orang lain untuk mulai belajar dari!

Langkah berikutnya

Itu saja! Anda telah berkontribusi pada konten Microsoft Learn!