Розібрати вхідні
Цей посібник показує, як працювати з вхідними: єдиною поверхнею, що збирає все, що вас блокує або явно стосується вас, — очікувані схвалення агентів, невдалі синхронізації тікетів і кожен 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 не пройшов), надішліть виправлення зі свого checkout або передайте подальшу роботу агенту.
- Якщо PR у розділі Схвалено, змерджте його зі сторінки деталей.
- Якщо ви волієте делегувати рев’ю, а не робити його самі, див. Запускати агентів-рев’юерів і життєвий цикл запуску.
Щойно відповідний стан зміниться (ваше рев’ю надійшло, PR змерджено), класифікатор автоматично перекласифіковує PR у його новий розділ.
Скасувати помилкову дію
Розділ із назвою «Скасувати помилкову дію»- Натисніть ⌘Z, щоб скасувати останню дію, ⌘⇧Z — щоб повернути її.
- Якщо текстове поле у фокусі, ⌘Z натомість редагує текст поля — спершу вийдіть із поля, щоб скасувати дію рівня застосунку.
Дізнатися сполучення на місці
Розділ із назвою «Дізнатися сполучення на місці»Натисніть ? (коли жодне текстове поле не у фокусі), щоб відкрити шпаргалку зі сполучень клавіш. Вона перелічує кожну прив’язку, активну на поточному маршруті, зокрема f — сполучення фільтра у вхідних. Повну карту наведено в довіднику гарячих клавіш.
Керувати з палітри команд
Розділ із назвою «Керувати з палітри команд»- Натисніть ⌘K будь-де, щоб відкрити палітру команд.
- Введіть Вхідні, щоб перейти на сторінку, або введіть назву PR — палітра покаже відповідні pull request і відкриє вибраний.
- Коли вхідні відкрито, виконайте Копіювати посилання на цю сторінку, щоб скопіювати цю URL-адресу для надсилання. Команда копіює поточний маршрут, тож це URL-адреса вхідних лише тоді, коли ви на цій сторінці.
Оновити на вимогу
Розділ із назвою «Оновити на вимогу»Вхідні оновлюються наживо, але якщо ви підозрюєте, що дані застаріли, натисніть елемент оновлення на панелі інструментів — він негайно запускає серверний обхід кожного підключеного хоста коду й повторно завантажує накладення злитих і переглянутих. Значок обертається, доки не завершаться всі запити.