تریاژ صندوق ورودی
این راهنما نشان می‌دهد چگونه با صندوق ورودی کار کنید: همان یک سطحی که هر چیزی را که متوقف‌تان می‌کند یا صراحتاً شما را می‌خواهد گرد می‌آورد — تأییدهای در انتظار عامل، همگام‌سازی‌های ناموفق تیکت و هر pull requestی که شما را به‌عنوان بازبین یا نویسنده درگیر می‌کند.
باز کردن صندوق ورودی
بخش با عنوان “باز کردن صندوق ورودی”- در نوار کناری روی صندوق ورودی کلیک کنید. نشان آن، تأییدهای در انتظار عامل، همگام‌سازی‌های ناموفق و PRهای بازی را که در انتظار بازبینی شما هستند می‌شمارد.
- یا ⌘K را فشار دهید و فرمان پیمایش صندوق ورودی را اجرا کنید.
- یا مستقیماً به
/workspaces/<workspace-id>/inboxپیوند عمیق بزنید.
مدخل نوار کناری همیشه شمارش زنده را نشان می‌دهد، پس می‌توانید ببینید کار تریاژ بدون باز کردن صفحه روی هم جمع می‌شود.
خواندن شدت در یک نگاه
بخش با عنوان “خواندن شدت در یک نگاه”از بالا به پایین نگاه کنید؛ صندوق ورودی از قبل بر اساس فوریت مرتب شده است:
- نوار سنجاق‌شدهٔ نیاز به توجه شما بالای بخش‌های PR قرار دارد. هر کارت یک تراشهٔ شدت دارد. منابع ثبت‌شده (عاملی که روی یک درخواست تأیید گیر کرده، یا همگام‌سازی تیکتی که آینهٔ فروشنده‌اش کهنه شده) مسدود منتشر می‌کنند.
- درون نوار، فوری‌ترین شدت اول می‌آید؛ در صورت تساوی، نوبت به موردی می‌رسد که بیشترین زمان را در انتظار مانده است.
- زیر نوار، PRها در بخش‌های ثابت چرخهٔ عمر بازبینی گروه‌بندی می‌شوند — نیاز به بازبینی شما، بازگشته به شما، تأییدشده، پیش‌نویس‌ها، در انتظار بازبین‌ها، در حال ادغام و اخیراً ادغام‌شده، در انتظار نویسنده. بخش‌های بالایی همان چیزی است که به شما نیاز دارد؛ بقیه جایی است که PRهای شما ایستاده‌اند. نیاز به بازبینی شما شامل PRهایی هم می‌شود که هنوز تیمی را درخواست می‌کنند که شما عضو آن هستید، در میزبان‌های کدی که این قابلیت را دارند (GitHub به‌محض اینکه هر هم‌تیمی بازبینی کند، تیم را حذف می‌کند).
یک مورد تنها وقتی در صندوق ورودی می‌نشیند که چیزی را مسدود کند یا صراحتاً شما را درخواست کند. نوار خالی به‌همراه فهرست بخش‌های خالی، تنها وقتی همه را دیده‌اید را نشان می‌دهد که این خالی بودن قابل اعتماد باشد.
یک صندوق ورودی در سراسر همهٔ میزبان‌های کد
بخش با عنوان “یک صندوق ورودی در سراسر همهٔ میزبان‌های کد”اگر فضای کاری مخزن‌هایی روی بیش از یک میزبان کد داشته باشد، صندوق ورودی آن‌ها را در
یک جریان واحد ادغام می‌کند — یک pull request از GitHub و یک pull request از Bitbucket
در همان بخش می‌نشینند و بر اساس زمان مرتب می‌شوند، نه گروه‌بندی‌شده بر پایهٔ فروشنده.
فرادادهٔ repo #number هر ردیف همان چیزی است که آن‌ها را از هم جدا می‌کند.
«مال شما» به تفکیک هر میزبان کد حل می‌شود، چون شما روی هر کدام حساب دیگری هستید. یک pull request تنها وقتی مال شما شمرده می‌شود، یا وقتی درخواست بازبینی شما شمرده می‌شود، که با هویت شما روی میزبانی بخواند که مخزن واقعاً روی آن قرار دارد.
میزبان کدی که از کار افتاده یا متصل نیست چیزی اضافه نمی‌کند و بقیهٔ صندوق ورودی را دست‌نخورده می‌گذارد — یک اتصال خراب هرگز تمام فهرست را خالی نمی‌کند. حالت خالی وقتی هر ورود به میزبان کد هنوز حل نشده باشد (تأیید حساب GitHub شما ممکن نشد — متن همچنان GitHub را نام می‌برد)، وقتی githubstatus.com یک رخداد گزارش کند، یا وقتی نصب GitHub App که مخزن‌های پیوندشده را پوشش می‌دهد معلق شده باشد، به‌جای همه را دیده‌اید یک هشدار را نام می‌برد.
پاک کردن نوار توجه
بخش با عنوان “پاک کردن نوار توجه”هر کارت نوار یک اقدام بعدی دارد:
- اگر کارت یک تأیید در انتظار عامل باشد، روی بازبینی کلیک کنید — با تأیید در انتظار آن، وارد فضای همان عامل می‌شوید. همان‌جا تأیید یا رد کنید (به گفتگو با یک عامل نگاه کنید).
- اگر کارتی برای یک فروشنده همگام‌سازی ناموفق را نشان دهد، روی باز کلیک کنید — وارد تنظیمات → فضای کاری → عمومی می‌شوید که کارت سلامت همگام‌سازی آن، آخرین همگام‌سازی، زنجیرهٔ شکست‌های پیاپی و آخرین نتیجهٔ هر اتصال را نشان می‌دهد. تنها آخرین شکست هر فروشنده در صندوق ورودی می‌آید، پس همگام‌سازی بازیابی‌شده کارت را پاک می‌کند.
- کارت‌ها به‌محض اینکه وضعیت زیربنایی حل شود (به عامل پاسخ داده شود، همگام‌سازی بهبود یابد) خودبه‌خود ناپدید می‌شوند — چیزی برای بستن دستی وجود ندارد.
فیلتر کردن تا آنچه مانع است
بخش با عنوان “فیلتر کردن تا آنچه مانع است”- برای باز کردن منوی فیلتر، f را فشار دهید (وقتی هیچ فیلد متنی متمرکز نیست)، یا روی دکمهٔ فیلتر در نوار ابزار کلیک کنید.
- هر ترکیبی از وضعیت، نویسنده، بازبین‌ها، محتوا، مالک/نام مخزن، بازه‌های تاریخ، یا بازبینی سریع را انتخاب کنید. شمارش‌های وجه در منو نشان می‌دهند هر گزینه با چند مورد صندوق ورودی مطابقت دارد.
- فیلترهای فعال به‌شکل تراشه در نوار بالای فهرست ظاهر می‌شوند؛ برای حذف آن معیار روی ✕ هر تراشه کلیک کنید.
- از ریل کناری برای پریدن میان بخش‌ها استفاده کنید — هر مدخل شمارش زنده‌اش را نشان می‌دهد و برجسته‌سازی موقعیت اسکرول شما را دنبال می‌کند. برای جمع کردن بخش‌هایی که تریاژ نمی‌کنید روی سرصفحهٔ بخش کلیک کنید (مثلاً پیش‌نویس‌ها هنگام پاک کردن بازبینی‌ها).
- برای مرتب‌سازی همهٔ بخش‌ها روی سرصفحهٔ ستون (عنوان، تغییرات یا به‌روزرسانی) کلیک کنید؛ برای وارونه کردن جهت دوباره روی ستون فعال کلیک کنید. دکمهٔ گزینه‌های نمایش، نمایان بودن پیش‌نویس‌ها، بازهٔ اخیراً ادغام‌شده، ویژگی‌های ردیف، ترتیب و گروه‌بندی را کنترل می‌کند (تنها گروه‌بندی بر اساس نویسنده چیدمان صندوق ورودی را تغییر می‌دهد).
فیلترهای اینجا از صف PR مستقل‌اند — باریک کردن صندوق ورودی هرگز فیلترهای صف را تغییر نمی‌دهد و برعکس.
اقدام روی یک مورد PR
بخش با عنوان “اقدام روی یک مورد PR”- برای باز کردن صفحهٔ جزئیات PR روی هر ردیفی کلیک کنید.
- اگر PR در نیاز به بازبینی شما است، آن را بازبینی و تصمیم‌تان را ثبت کنید — به بازبینی و ادغام یک PR نگاه کنید.
- اگر PR در بازگشته به شما است (تغییرات درخواست شده یا CI شکست خورده)، اصلاحات را از چک‌آوت خودتان push کنید یا پیگیری را به یک عامل بسپارید.
- اگر PR در تأییدشده است، آن را از صفحهٔ جزئیات ادغام کنید.
- اگر ترجیح می‌دهید بازبینی را واگذار کنید تا خودتان انجام دهید، به اعزام عامل‌های بازبین و چرخهٔ عمر اعزام نگاه کنید.
به‌محض اینکه وضعیت زیربنایی تغییر کند (بازبینی شما ثبت شود، PR ادغام شود)، طبقه‌بند به‌طور خودکار PR را در بخش جدیدش جای می‌دهد.
واگرداندن یک اقدام اشتباه
بخش با عنوان “واگرداندن یک اقدام اشتباه”- برای واگرداندن آخرین اقدام ⌘Z و برای ازنو انجام دادنش ⌘⇧Z را فشار دهید.
- اگر یک فیلد متنی متمرکز باشد، ⌘Z به‌جای آن متن فیلد را ویرایش می‌کند — برای واگرداندن یک اقدام در سطح برنامه، ابتدا از فیلد بیرون کلیک کنید.
میانبرها را همان‌جا جست‌وجو کنید
بخش با عنوان “میانبرها را همان‌جا جست‌وجو کنید”برای باز کردن برگهٔ میانبرهای صفحه‌کلید ? را فشار دهید (وقتی هیچ فیلد متنی متمرکز نیست). این برگه هر پیوند فعال روی مسیر فعلی را فهرست می‌کند، از جمله میانبر فیلتر f صندوق ورودی. نقشهٔ کامل در مرجع میانبرهای صفحه‌کلید است.
آن را از پالت فرمان هدایت کنید
بخش با عنوان “آن را از پالت فرمان هدایت کنید”- برای باز کردن پالت فرمان، هرجایی ⌘K را فشار دهید.
- برای پریدن به صفحه صندوق ورودی را تایپ کنید، یا عنوان یک PR را تایپ کنید — پالت pull requestهای منطبق را فهرست می‌کند و هر کدام را انتخاب کنید باز می‌کند.
- وقتی صندوق ورودی باز است، برای کپی آن URL جهت اشتراک‌گذاری فرمان کپی پیوند این صفحه را اجرا کنید. این فرمان مسیر فعلی را کپی می‌کند، پس تنها وقتی روی این صفحه‌اید URL صندوق ورودی است.
تازه‌سازی در صورت نیاز
بخش با عنوان “تازه‌سازی در صورت نیاز”صندوق ورودی زنده به‌روزرسانی می‌شود، اما اگر گمان می‌کنید داده کهنه است، روی کنترل تازه‌سازی در نوار ابزار کلیک کنید — این کار یک جست‌وجوی فوری سمت سرور روی هر میزبان کد متصل را وادار می‌کند و لایه‌های ادغام‌شده/بازبینی‌شده را دوباره می‌گیرد. نماد تا زمان تثبیت هر واکشی می‌چرخد.