Meningkatkan deskripsi permintaan pull menggunakan templat

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Menulis deskripsi permintaan pull yang baik adalah cara yang bagus untuk membantu peninjau mengetahui apa yang diharapkan saat meninjau kode. Ini juga cara yang bagus untuk membantu melacak hal-hal yang perlu dilakukan untuk setiap perubahan, seperti pengujian, menambahkan pengujian unit, dan memperbarui dokumentasi. Templat permintaan pull dapat membantu pengembang Anda membuat deskripsi permintaan pull hebat yang memenuhi standar organisasi Anda.

Artikel ini menunjukkan cara memulai dengan template pull request.

Nota

Templat permintaan pull dapat memberikan panduan, tetapi hanya saran. Gunakan kebijakan cabang untuk menerapkan praktik terbaik seperti memerlukan permintaan pull untuk cabang utama seperti utama, memerlukan build yang berhasil, dan memberlakukan peninjau yang diperlukan. Untuk informasi selengkapnya, lihat kebijakan cabang.

Prasyarat

Kategori	Persyaratan
Akses proyek	Anggota proyek .
Izin	- Lihat kode dalam proyek pribadi: Setidaknya akses Dasar . - Mengkloning atau berkontribusi pada kode dalam proyek privat: Anggota grup keamanan Kontributor atau izin-izin yang sesuai di dalam proyek. - Atur izin cabang atau repositori: Kelola izin untuk cabang atau repositori. - Ubah cabang default: Edit kebijakan dan izin untuk repositori. - Impor repositori: Anggota Administrator Proyek grup keamanan atau tingkat proyek Git Buat repositori dengan izin diatur ke Izinkan. Untuk informasi selengkapnya, lihat Mengatur izin repositori Git.
Layanan	Repos diaktifkan.
Alat	Fakultatif. Gunakan perintah az repos: Azure DevOps CLI.

Nota

Dalam proyek publik, pengguna dengan akses Stakeholder memiliki akses penuh ke Azure Repos, termasuk melihat, menyalin, dan berkontribusi pada kode.

Apa itu templat permintaan pull?

Templat permintaan pull adalah file yang berisi teks Markdown yang ditambahkan ke deskripsi permintaan pull Anda saat permintaan pull dibuat.

Thank you for your contribution to the Fabrikam Fiber repo. 
Before submitting this PR, please make sure:

- [ ] Your code builds clean without any errors or warnings
- [ ] You are using approved terminology
- [ ] You have added unit tests

Azure Repos memungkinkan Anda membuat jenis templat permintaan pull berikut:

• Templat default permintaan tarik yang secara otomatis diterapkan untuk semua permintaan tarik baru di repositori, kecuali digantikan oleh templat permintaan tarik khusus cabang.
• Templat permintaan pull khusus cabang yang secara otomatis diterapkan ke permintaan pull yang menargetkan cabang tertentu
• Templat permintaan pull tambahan yang dapat ditambahkan secara opsional oleh pembuat permintaan pull

Jenis templat permintaan pull ditentukan oleh nama file dan lokasi foldernya, seperti yang dibahas di bagian berikut. Nama file dan lokasi folder tidak peka huruf besar/kecil, tetapi harus berada di cabang default repositori Anda.

Nota

Semua file templat permintaan pull harus terletak di cabang default (biasanya utama) dari repositori Anda. Hanya file templat permintaan pull dari cabang default yang digunakan.

Templat permintaan pull default

Templat permintaan pull default secara otomatis diterapkan ke bidang deskripsi saat permintaan pull baru dibuat. Untuk mengonfigurasi repositori Anda dengan templat permintaan pull default, buat file bernama pull_request_template.md atau pull_request_template.txt dan simpan di cabang default repositori Anda di salah satu folder berikut.

• Folder bernama .azuredevops yang terkandung dalam folder akar repositori
• Folder bernama .vsts yang terkandung dalam folder akar repositori
• Folder bernama docs yang terkandung dalam folder akar repositori
• Folder akar repositori

Beberapa lokasi disediakan untuk memberi Anda fleksibilitas di tempat Anda menyimpan templat permintaan pull Anda. Saat permintaan pull dibuat, Azure Repos mencari folder yang ditunjuk dalam urutan yang diberikan, dan menggunakan templat permintaan pull default pertama yang ditemukannya.

Saat permintaan pull baru dibuat di repositori, kecuali templat permintaan pull khusus cabang berlaku, konten templat permintaan pull default digunakan untuk mengisi bidang deskripsi sebelumnya dalam permintaan pull.

Anda dapat mengedit atau menambahkan ke deskripsi ini dan menambahkan templat permintaan pull tambahan jika diinginkan dengan memilihnya dari menu drop-down Tambahkan templat .

Nota

Ketika templat permohonan pull default atau khusus cabang diterapkan secara otomatis, templat tersebut menggantikan pesan komit standar yang biasanya digunakan untuk deskripsi default. Anda bisa menambahkannya lagi dengan memilih Tambahkan pesan komit.

Templat permintaan pull khusus cabang

Templat permintaan pull khusus cabang dapat dikonfigurasi untuk permintaan pull yang menargetkan cabang tertentu. Untuk mengonfigurasi repositori Anda dengan templat permintaan pull khusus cabang, buat file atau .txt bernama .md sesuai cabang Anda. Nama harus cocok dengan tingkat pertama nama cabang, seperti main, , devrelease, atau feature. Setiap templat permintaan pull khusus cabang diterapkan kapan saja permintaan pull menargetkan cabang tersebut atau cabang apa pun yang terkandung di bawahnya. Misalnya, templat permintaan tarik bernama feature.md akan diterapkan jika permintaan tarik menargetkan cabang feature atau cabang feature/* mana pun.

Templat permintaan pull khusus cabang harus disimpan di cabang default repositori Anda menggunakan hierarki folder berikut: pull_request_template/branches/. Folder ini harus didasarkan pada salah satu folder berikut di repositori Anda.

• Folder bernama .azuredevops yang terkandung dalam folder akar repositori
• Folder bernama .vsts yang terkandung dalam folder akar repositori
• Folder bernama docs yang terkandung dalam folder akar repositori
• Folder akar repositori

Misalnya, templat permintaan pull khusus cabang yang harus berlaku untuk semua permintaan pull ke dev cabang akan diberi nama dev.md atau dev.txt dan terletak di salah satu lokasi berikut.

• <repository root>/.azuredevops/pull_request_template/branches/
• <repository root>/.vsts/pull_request_template/branches/
• <repository root>/docs/pull_request_template/branches/
• <repository root>/pull_request_template/branches/

Sama seperti templat permintaan pull default, beberapa lokasi disediakan untuk memberi Anda fleksibilitas di mana Anda menyimpan templat permintaan pull khusus cabang. Saat permintaan tarik dibuat, Azure Repos mencari folder yang ditunjuk dalam urutan yang diberikan untuk templat permintaan tarik khusus cabang, dan menggunakan yang pertama yang ditemukan yang sesuai dengan nama cabang. Jika tidak ada templat permintaan pull khusus cabang yang ditemukan, Azure Repos kemudian mencari templat permintaan pull default seperti yang dijelaskan di bagian Templat permintaan pull Default sebelumnya.

Templat permintaan pull tambahan

Selain templat permintaan pull default dan cabang tertentu, Anda dapat mengonfigurasi templat permintaan pull tambahan. Ini bisa berupa .md file atau .txt , yang terletak di salah satu folder berikut di cabang default Anda.

• <repository root>/.azuredevops/pull_request_template/
• <repository root>/.vsts/pull_request_template/
• <repository root>/docs/pull_request_template/
• <repository root>/pull_request_template/

Saat permintaan pull dibuat, Anda dapat menambahkan salah satu templat permintaan pull yang tersedia dengan memilihnya dari menu drop-down Tambahkan templat . Nama-nama dalam daftar drop-down didasarkan pada nama-nama file templat.

Dalam contoh berikut, tiga templat dicantumkan.

• dev.md - Ini adalah templat khusus cabang yang diterapkan secara default ke permintaan pull ini ke cabang dev, seperti yang ditunjukkan oleh pesan default yang tercantum setelah nama file.
• additional.md - Ini adalah templat tambahan.
• pull_request_template.md - Ini biasanya templat default tetapi ditimpa oleh dev.md templat khusus cabang dalam permintaan pull ini. Meskipun tidak ditambahkan secara default, itu masih dapat diterapkan dengan memilihnya dari daftar.

Pilih nama templat tambahan yang diinginkan untuk menambahkan kontennya ke deskripsi permintaan pull saat ini.

Nota

Anda dapat menentukan templat permintaan pull untuk mengambil alih permintaan pull default atau cabang tertentu yang cocok dengan menambahkan ?template=name.md ke querystring.

Lihat juga

• Membuat permintaan pull untuk meninjau dan menggabungkan kode
• Tentang cabang dan kebijakan cabang