اولین pull request را بازبینی کنید

آنچه خواهید ساخت

در پایان این آموزش، این‌ها را در اختیار خواهید داشت:

• یک pull request را در میزکار PR مربوط به Control Center باز کرده‌اید
• دیف آن را خوانده‌اید و یک نظر درون‌خطی گذاشته‌اید
• یک حکم بازبینی ثبت کرده‌اید
• PR را ادغام کرده‌اید

پیش‌نیازها: اولین عامل را اعزام کنید را کامل کرده باشید و یک pull request باز روی مخزنی داشته باشید که در این فضای کاری ثبت شده است. برای گام‌های بازبینی، PRی را برگزینید که خودتان باز نکرده‌اید — دکمهٔ بازبینی روی PRهای خودتان پنهان است. ادغام روی PRی که خودتان نوشته‌اید هم کار می‌کند.

گام 1: باز کردن pull request

1. در نوار کناری روی Pull requestها کلیک کنید
2. PR خود را پیدا کنید و روی آن کلیک کنید

نقطهٔ بررسی. PR به‌شکل میزکاری زبانه‌دار باز می‌شود — نمای کلی، دیف، کنترل منبع، گفتگو، کنش‌ها — با تمرکز روی نمای کلی: عنوان و کنش‌ها، توضیحات و خط زمانی فعالیت، و یک نوار کناری با وضعیت، بازبین‌ها، تخصیص‌یافته‌ها، بررسی‌ها و فایل‌های تغییریافته. کلیک روی یک فایل در آنجا شما را به همان فایل در زبانهٔ دیف می‌برد. زبانهٔ بازبینی PR تا وقتی کسی درخواست بازبینی هوش مصنوعی نکند باز نمی‌شود.

صف خالی با درخواست «GitHub را وصل کنید»

این وضعیت یعنی سرور هیچ توکن GitHubی نگه نمی‌دارد — کلاینت شما هرگز توکنی نگه نمی‌دارد. یکی را در تنظیمات → فضای کاری → نمایه و هویت → میزبانی کد تنظیم کنید، سپس فهرست را تازه‌سازی کنید.

گام 2: خواندن دیف

زبانهٔ دیف را باز کنید. یک درخت فایل جمع‌شدنی در سمت چپ می‌نشیند و نوار بالای دیف یک انتخابگر بازهٔ کامیت را حمل می‌کند — دیف را به یک کامیت یا بازه‌ای از آن‌ها محدود کنید — به‌همراه شمار فایل‌ها و افزوده‌ها و حذف‌های جاری.

دکمهٔ تنظیمات در نوارابزار دیف نحوهٔ رندر آن را کنترل می‌کند:

• نمای شکافته یا یکپارچه
• شکستن خط یا پیمایش خطوط بلند
• لیگاتور فونت کد

یک فایل را دیده‌شده علامت بزنید تا پیشرفتتان را در یک دیف بزرگ پیگیری کنید. پیمایش با صفحه‌کلید در میانبرهای صفحه‌کلید آمده است.

گام 3: گذاشتن نظر درون‌خطی

1. روی یک خط در دیف شناور شوید — یک دکمهٔ قرصی‌شکل کوچک + در حاشیه ظاهر می‌شود
2. برای گذاشتن نظر روی آن خط کلیک کنید، یا نخست آن را عمودی بکشید تا بازه‌ای انتخاب شود
3. بازخوردتان را بنویسید. کادر نوشتن دو راه ارسال پیشنهاد می‌دهد:
   • شروع بازبینی (یا افزودن به بازبینی اگر بازبینی‌ای از قبل در جریان است) نظر را صف می‌کند. رشته تا وقتی در گام 4 حکمی ثبت نکنید بازبینی در انتظار را نشان می‌دهد.
   • افزودن نظر تکی بی‌درنگ آن را در GitHub منتشر می‌کند. رشته در حال ارسال… و سپس همگام‌شده را نشان می‌دهد و اگر ارسال شکست بخورد، تلاش دوباره پیشنهاد می‌دهد.

در این آموزش، از شروع بازبینی استفاده کنید تا نظر همراه با حکم بیرون برود.

نظر صف‌شده هنوز در GitHub نیست

شروع بازبینی / افزودن به بازبینی نظر را تا وقتی حکمی ثبت نکنید به‌صورت محلی نگه می‌دارند. تنها افزودن نظر تکی بی‌درنگ منتشر می‌کند. بدنهٔ بازبینی که در گام 4 می‌نویسید پیش‌نویسی جداست.

گام 4: ارسال بازبینی

1. در ردیف کنش‌های نمای کلی روی بازبینی کلیک کنید — همان دکمه در نوارابزار زبانهٔ دیف هم می‌نشیند. روی PRهایی که خودتان نوشته‌اید و روی PRی بسته یا ادغام‌شده پنهان است.
2. در کادر نوشتن خلاصه‌ای بنویسید. به‌صورت خودکار به‌عنوان پیش‌نویس ذخیره می‌شود، پس می‌توانید پوشش را ببندید و بازگردید.
3. یک حکم برگزینید:
   • درخواست تغییرات
   • نظر
   • تأیید

حکم همان دکمه است. پس از تأیید یا درخواست تغییرات، دکمه خودش را به تأییدشده یا تغییرات درخواست‌شده برچسب می‌زند. حکم نظر آن را با برچسب بازبینی رها می‌کند.

نقطهٔ بررسی. اگر یکی از آن دو را برگزیده باشید، دکمه «تأییدشده» یا «تغییرات درخواست‌شده» را نمایش می‌دهد.

گام 5: ادغام

دکمهٔ ادغام هر زمان که GitHub PR را قابل ادغام گزارش کند حاضر است — به تأیید خودتان گره نخورده است. رنگش آمادگی را گزارش می‌کند نه مجوز را: اصلی وقتی تأییدهای لازم و بررسی‌ها سبز باشند، ثانویه تا وقتی بررسی‌ای در حال اجراست، و تخریبی وقتی بازبین درخواست‌شده تأیید نکرده باشد یا بررسی‌ای ناموفق باشد.

1. روی ادغام کلیک کنید
2. یک روش برگزینید: اسکواش و ادغام، ایجاد کامیت ادغام یا ریبیس و ادغام
3. برای دو مورد نخست، عنوان و پیام پیش‌پرشدهٔ کامیت را ویرایش کنید
4. تأیید کنید

هر مشکل باقی‌مانده‌ای — «بررسی‌ها ناموفق»، «بعضی بازبینی‌ها در انتظارند» — پیش از تأیید در پنجرهٔ شناور فهرست می‌شود.

ادغام بازگشت‌ناپذیر است

ادغام کامیت‌ها را به GitHub می‌فرستد. هرگز به پشتهٔ واگرد Control Center وارد نمی‌شود و از اینجا نمی‌توان آن را واگرد کرد.

پس از ادغام، یک رویداد دامنهٔ PrMerged برمی‌خیزد؛ تحلیل‌ها و اعلان‌ها آن را مصرف می‌کنند. برای اینکه چه چیز دیگری گوش می‌دهد، رویدادهای دامنه را ببینید.

بازبینی با هوش مصنوعی

Control Center می‌تواند یک پایپ‌لاین بازبین را روی یک PR باز بگذارد، اما تنها وقتی که بخواهید: قالب pr_review یک تریگر دستی دارد و بس.

1. منوی سرریز را در ردیف کنش‌های نمای کلی باز کنید و پرسش از AI را برگزینید. Control Center اجرا را شروع می‌کند و زبانهٔ بازبینی PR را باز می‌کند تا بتوانید کار متخصصان را تماشا کنید.
2. عامل‌های بازبین یافته‌هایشان را به‌صورت گره‌های بازبینی در فضای PR ثبت می‌کنند؛ یک گام نهایی آن‌ها را در یک گزارش یکپارچه می‌کند.

پایپ‌لاین عمداً در GitHub منتشر نمی‌کند — پس از یکپارچه‌سازی پایان می‌یابد. انتشار گامی جداست که خودتان برمی‌دارید، با دکمهٔ انتشار در GitHub در زبانهٔ بازبینی PR. استفاده از بازبینی مبتنی بر هوش مصنوعی را ببینید.

خلاصه

یک PR را در میزکار باز کردید، دیف را با برجسته‌سازی نحو خواندید، یک نظر درون‌خطی گذاشتید، حکمی ثبت کردید و ادغام کردید — بدون آنکه از برنامه بیرون بروید.

بعدی: اولین پایپ‌لاین را بسازید تا جریان‌های کاری چندگامی را خودکار کنید.