Semak dan cantumkan PR

Panduan ini menunjukkan cara menyemak dan mencantumkan pull request.

Buka meja kerja PR

Navigasi ke Pull request di bar sisi
Pilih satu PR daripada senarai

PR terbuka sebagai meja kerja bertab, bukan satu halaman tunggal. Lima tab terbuka secara lalai, mengikut susunan ini: Gambaran keseluruhan, Diff, Kawalan sumber, Sembang dan Tindakan (pemeriksaan CI dikelompokkan mengikut aliran kerja). Semakan — kemajuan pipeline semakan, kemudian artifak yang diterbitkannya bersama rel penemuannya — sengaja bukan salah satu daripadanya: sesuatu PR tiada semakan sehingga seseorang memintanya, jadi Tanya AI membukanya. Terminal, editor satu fail, code-server terbenam dan pelayar dalam apl terbuka mengikut keperluan; tab pratonton penerapan disuntik secara automatik apabila URL pratonton dikesan pada PR itu. Susun atur tab anda diingati bagi setiap PR.

Tab Gambaran keseluruhan membawa metadata PR itu (pengarang, cawangan, label, penerima tugasan, tindak balas, commit, status pemeriksaan) dan baris tindakan: muat semula, Semakan, Cantum, buka dalam IDE dan menu limpahan ⋯.

Baca diff

Buka tab Diff untuk melihat keseluruhan diff PR sekali gus, dengan pokok fail untuk melompat antara fail.

Butang tetapan dalam bar alat diff menukar paparan belah (sebelah-menyebelah) dan bersatu serta menogol pembalutan baris dan ligatur fon kod.
Pengepala hunk @@ digantikan dengan afordans Show N lines / Show end of file yang menyambung konteks di sekeliling apabila diklik.
Tekan j / k untuk melangkah antara fail, c untuk meruntuhkan atau mengembangkan fail yang difokuskan, t untuk mengembalikan bar sisi kepada pokok fail dan ⌘F untuk mencari merentas keseluruhan diff (Enter / Shift+Enter menelusuri padanan).
Tekan v untuk menandakan fail yang difokuskan sebagai dilihat, dan kursor mara ke fail seterusnya. Pada GitHub, keadaan dilihat disimpan pada forge, jadi ia mengikut anda antara klien; GitLab dan Bitbucket tiada API sebegitu, jadi di sana ia diingati pada peranti ini sahaja.

Seret dengan tetikus dalam kawasan kod memilih teks sehingga lajur yang tepat dan ⌘C menyalin sumber mentah dan bukannya penanda diff yang dipaparkan.

Tinggalkan komen sebaris

Ketik margin baris kod untuk membuka komposer yang bersauh pada baris itu, atau gunakan butang + pada pengepala fail untuk komen peringkat fail
Tulis maklum balas anda dalam Markdown
Hantar

Pada GitHub dan GitLab, komposer menawarkan dua cara hantar: Tambah komen tunggal menyiarkan serta-merta, manakala Mula semakan / Tambah ke semakan memasukkan komen itu ke dalam semakan tertunda yang keluar bersama Luluskan, Minta perubahan atau Komen. Bitbucket tiada pengumpulan semakan tertunda, jadi di sana setiap penghantaran disiarkan serta-merta. Penyiatan serta-merta menunjukkan keadaan tertunda sehingga forge mengesahkannya, kemudian bertukar kepada disegerakkan. Jika penyiatan gagal, utas itu ditandakan dengan ralat dan menawarkan cuba semula.

Hanya badan semakan yang menjadi draf: ia disimpan di pihak pelayan terhadap (owner, repo, nombor PR) seketika selepas anda berhenti menaip, jadi ia terselamat daripada muat semula dan mengikut anda antara klien desktop dan web.

Hantar semakan

Tekan Semakan dalam baris tindakan Gambaran keseluruhan (ia tersembunyi pada PR anda sendiri dan pada PR yang ditutup atau dicantum)
Tulis badan semakan. Anda boleh melampirkan imej, menyisipkan emoji atau GIF dan menogol antara tulis dan pratonton
Tekan Minta perubahan, Komen atau Luluskan

Keputusan itu ialah butangnya — tiada pemilih keputusan yang berasingan. Selepas Luluskan atau Minta perubahan, butang itu melabel semula dirinya sebagai Diluluskan atau Perubahan diminta dan badan draf dikosongkan. Keputusan Komen membiarkan butang itu berlabel Semakan.

Cantum

Butang Cantum muncul apabila anda mempunyai akses tulis dan PR itu terbuka serta bukan draf. Warnanya ialah isyarat kesediaan yang diperoleh daripada kelulusan yang diperlukan dan keadaan pemeriksaan (sedia / tertunda / disekat) — ia bersifat nasihat sahaja. Butang itu tidak pernah dilumpuhkan oleh keadaan semakan; perlindungan cawangan forge sendiri itulah yang menguatkuasakan peraturan itu.

Tekan Cantum untuk membuka panel timbul cantuman
Pilih kaedah cantuman: squash, commit cantuman atau rebase (squash ialah lalai). Bitbucket tiada cantuman rebase sebenar, jadi rebase dipetakan kepada strategi fast-forward-nya dan gagal pada cawangan yang menyimpang
Untuk squash dan commit cantuman, edit tajuk dan penerangan commit yang telah diisi awal. Rebase tidak mengambil kedua-duanya dan menyembunyikan kedua-dua medan itu
Baca panel amaran — ia menamakan pemeriksaan yang gagal dan semakan yang tertunda, tetapi tidak menyekat anda
Tekan butang cantum dalam panel itu untuk mengesahkan

Mencantum tidak boleh dipulihkan: ia menolak commit ke forge, jadi ia mendapat langkah pengesahan dan bukannya entri buat asal. Selepas itu, cache PR itu dilumpuhkan, statusnya bertukar kepada Dicantum dan acara PullRequestStatusChanged tercetus dengan status merged. Acara itu melepaskan worktree “buka dalam editor” yang efemeral dan memulakan dua pipeline yang dibenihkan: Stale repository cleanup, yang membuang worktree dan folder perbualan PR yang sudah usang, dan Release notes, yang merangka entri log perubahan.

Serahkan PR kepada ejen penyemak

Menu limpahan ⋯ pada tab Gambaran keseluruhan membawa Tanya AI, yang memulakan pipeline pr_review yang dibenihkan untuk PR ini. Ia hanya muncul semasa PR terbuka. Lihat Gunakan semakan berkuasa AI untuk apa yang dilakukan oleh pipeline itu dan cara menerbitkan penemuannya, dan Pengiraan semakan untuk model kohort dan paksi yang deterministik.

Semak PR luaran

Control Center turut mengimport PR yang dibuka oleh manusia di luar apl. Aliran semakan di atas adalah sama. PR luaran dikesan oleh perkhidmatan pengundian PR.