Bagikan melalui

Meninjau permintaan pull terbuka di GitHub

  • Artikel

Artikel ini menjelaskan cara berkontribusi ke Microsoft Learn dengan meninjau permintaan pull (PR) dan menambahkan komentar Anda. Anda dapat membaca topik baru dan melihat pembaruan yang diusulkan sebelum diterbitkan dengan memeriksa antrean PR terbuka repositori GitHub publik. Umpan balik komunitas tentang pembaruan yang diusulkan membantu seluruh komunitas.

Dengan komentar dan ulasan PR, Anda dapat:

  • Tambahkan dan balas komentar di PR.
  • Bereaksi terhadap komentar dengan emoji seperti 👍, ❤️ , dan 🎉 .

Prasyarat

  • Buat akun GitHub, jika Anda tidak memilikinya.

Menemukan PR

  1. Di browser Anda, navigasikan ke repositori di GitHub yang ingin Anda tinjau. Jika Anda tidak yakin repositori mana yang harus dilihat, temukan repositori yang menarik bagi Anda dalam daftar repositori Microsoft Learn kami.

    Jika Anda menelusuri dokumentasi dan tidak tahu repositori mana yang dimilikinya, pilih ikon Edit pensil di bagian atas halaman. Tindakan ini membawa Anda ke file sumber di GitHub. Nama repositori ditampilkan di sudut kiri atas halaman. Misalnya, gambar berikut menunjukkan lokasi nama repositori untuk repositori azure-dev-docs .

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. Pilih tab Permintaan pull untuk melihat PR yang terbuka untuk repositori tersebut. Jika repositori memiliki banyak PR, gunakan bilah Filter untuk memfilter menurut label, penulis, dan banyak lagi. Atau gunakan bilah Pencarian untuk mencari kueri tertentu.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Buka PR dengan memilih tautan judul.

Meninjau PR

  1. Di PR yang Anda tinjau, pilih tab File yang diubah .

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

  2. Bandingkan dokumen asli dengan dokumen yang diedit. Dokumen asli akan berwarna merah, dan dokumen yang diusulkan akan berwarna hijau. Setiap teks yang ditambahkan akan disorot di bagian hijau (baru), dan teks apa pun yang dihapus akan disorot di bagian merah (asli).

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Tambahkan komentar atau sarankan perubahan dengan memilih ikon plus (+) di sebelah kiri baris yang ingin Anda komentari. Untuk memilih beberapa baris, pilih dan seret tanda plus.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Anda hanya dapat menambahkan komentar atau saran ke baris yang telah diedit di PR saat ini. Untuk membuat perubahan lain, edit file tersebut di PR Anda sendiri.

  4. Sebuah kotak akan terbuka. Masukkan komentar atau pertanyaan Anda di sana. Jika mau, Anda dapat menggunakan tombol di toolbar untuk memformat teks Anda, menambahkan daftar berpoin dan bernomor, atau menyisipkan blok kode dan gambar.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Anda juga dapat menyarankan perubahan pada teks di baris tersebut.

    1. Di toolbar untuk komentar, pilih +- ikon (mungkin ikon terjauh di sebelah kiri). Ini adalah tombol Sisipkan saran .

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. Teks dari baris yang Anda pilih akan disertakan dalam blok kode (di dalam dua set backticks ''').

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Untuk menyarankan perubahan pada teks yang menyertakan pagar kode tiga kali lipat ('''), ganti backtick luar/penutup suggestion dengan tilde (~~~).

    3. Edit teks. Gunakan tombol dalam kotak komentar untuk pemformatan sederhana seperti tebal, miring, dan poin, atau gunakan elemen sintaks Markdown secara langsung. Anda juga dapat menambahkan komentar ke kotak ini di bawah bagian blok kode.

  6. Setelah membuat komentar, pilih Mulai tinjauan. Penulis PR akan diberi tahu tentang perubahan Anda. Jika Anda menggunakan tombol Sisipkan saran di langkah sebelumnya, penulis akan dapat menerapkan saran Anda langsung ke dokumen.

    Jika Anda ingin membawa orang lain ke dalam percakapan, Anda dapat @mention kontributor lain dengan alias GitHub mereka di komentar Anda. Pengguna GitHub yang disebutkan akan menerima email yang berisi komentar Anda. Anda juga dapat menggunakan Markdown di komentar Anda, dan Markdown komentar Anda dirender setelah Anda mengirimkan komentar.

  7. Di tab Percakapan , baca komentar. Jika Anda memiliki pertanyaan atau komentar, tambahkan ke percakapan. Anda juga dapat menambahkan reaksi pada komentar dengan memilih ikon wajah tersenyum di sudut kiri bawah setiap komentar.

Kirimkan ulasan

Setelah Menambahkan semua komentar ke ulasan, kirimkan ulasan Anda.

  1. Pilih tombol Tinjau perubahan di kanan atas tab File yang diubah untuk membuka dialog kiriman tinjauan.
  2. Masukkan ringkasan Tinjauan deskriptif.
  3. Pilih tombol radio untuk jenis tinjauan yang Anda inginkan, lalu pilih Kirim tinjauan.

Submitting a review in GitHub.

Penulis PR akan menerima pemberitahuan ulasan.

Langkah berikutnya

Untuk mempelajari selengkapnya tentang komentar dan ulasan, lihat artikel ini di dokumentasi GitHub.