Stacked Pull Requests від GitHub тепер у публічному попередньому перегляді

GitHub представляє Stacked Pull Requests у публічному попередньому перегляді

GitHub оголосив про запуск Stacked Pull Requests у публічному попередньому перегляді. Ця функція призначена для розбиття великих змін на невеликі, придатні для перегляду запити на злиття (pull requests). Stacked Pull Requests являють собою впорядковану серію запитів, кожен з яких представляє сфокусовані шари зміни.

Основні можливості та переваги

Завдяки Stacked Pull Requests команди можуть незалежно переглядати та перевіряти кожен запит, а потім зливати все разом одним кліком. Це усуває необхідність відкривати один великий запит на злиття, який потребує багато часу для перегляду, або розділяти роботу між кількома гілками, які потрібно вручну ребейзити.

Тім Нойткенс, керівник Next.js у Vercel, зазначив, що використання Stacked PRs допомогло їм впроваджувати менші індивідуальні зміни при випуску більших функцій, що полегшило перегляд запитів.

Функція дозволяє командам:

• Підтримувати рух великих змін шляхом паралельного перегляду коротких, вузькоспрямованих запитів на злиття.
• Підтримувати якість на кожному шарі за допомогою сфокусованих переглядів запитів на злиття разом з існуючими захистами гілок.
• Зливати один, кілька або всі шари шляхом об'єднання всього стеку або окремих шарів по черзі.

Оскільки Stacked Pull Requests вбудовані в GitHub, існуючі перегляди, перевірки та вимоги до злиття працюють одразу.

Джон Резіг, творець jQuery, відзначив, що можливість зливати кілька Stacked PRs безпосередньо в чергу злиття одночасно значно зменшує тертя.

Як почати та працювати зі стеками

Щоб почати, користувачі можуть встановити розширення CLI за допомогою команди gh extension install github/gh-stack. Створювати стеки можна з терміналу або на github.com. Робота зі стеками підтримується на github.com, у GitHub CLI, мобільному додатку GitHub або за допомогою агента кодування, такого як GitHub Copilot, використовуючи навичку gh-stack.

Процес створення стеку починається з гілки та запиту на злиття для першої зміни. Потім додаються гілки та запити на злиття поверх неї; кожен запит націлений на шар, що знаходиться під ним.

Незалежний перегляд та гнучке злиття

Кожен шар можна переглядати незалежно. Відкривши будь-який запит на злиття в стеку, можна переглянути лише зміни для цього конкретного шару. Карта стеку у верхній частині запиту показує, як зміна вписується у більшу роботу. Команди можуть переглядати різні шари паралельно, не блокуючи подальшу роботу.

Енді Мерріман, технічний директор TED, зазначив, що Stacked PRs допомагають вирішити проблему великих запитів, розбиваючи їх на невеликі, впорядковані за залежностями частини, що призводить до швидших та точніших переглядів.

Злиття всього стеку відбувається одним кліком: злиття останнього готового запиту на злиття призводить до об'єднання його та всіх незлитих шарів під ним за одну операцію. Для злиття частини стеку можна об'єднати один або кілька нижніх шарів — запити на злиття вище залишаються відкритими та автоматично ребейзяться та перенацілюються. Існуючі захисти гілок та обов'язкові перевірки продовжують регулювати, що потрапляє в основну гілку.

Маянк Сайні, інженер з підключення у WHOOP, підкреслив, що Stacked PRs дозволяють переглядати великі зміни як серію невеликих запитів, які легко відстежувати, і весь стек зливається за один раз.

Доступність

Stacked Pull Requests поступово впроваджуються в публічному попередньому перегляді для всіх репозиторіїв протягом найближчих днів. Підтримка черги злиття для Stacked Pull Requests буде впроваджуватися поступово протягом найближчих тижнів.