GitHub issues для продакта: мітки, майлстоуни, PR

Alex Tutor

Понеділок третього тижня. Робота над балами лояльності розкидана по чатах, трьох pull requests і одному issue від CEO. Де б її шукала нова людина в команді?

Ви

Скрізь, і половину все одно не знайти. CEO минулого тижня відкрив #147. Назва: «Loyalty». Опис: «Need this before Black Friday!!» І це все.

Alex Tutor

Тоді дамо цій роботі нормальний дім. Issue (задача) це місце на GitHub для всього, про що команда має знати або що має зробити: звіт про баг, запит на фічу, задача. Зазвичай воно з'являється раніше за будь-який код.

Daniel

Issue це питання, а pull request одна з відповідей на нього. Pull request можна відкрити й без issue, але за місяць ніхто не згадає, яку проблему він розв'язував.

Alex Tutor

Issues у catchow/website, понеділок зранку

Loyalty#147
Відкрив CEO минулого тижня · без міток і виконавця
Test an orange checkout button#135
Мітка idea · відкрив Daniel
Checkout button stays grey after editing cart#131
Звіт про баг від підтримки · закрито через #134
Show prices in euros#138
Запит на фічу · закрито як незаплановане

Ви

Тобто #131 був звітом про баг, #138 запитом на фічу, від якого ми відмовились, а #135 ідеєю, що чекає на тест.

Alex Tutor

А #147 це запит на фічу, який поки не каже, що це за фіча. Сьогодні це виправимо. Але спершу навчімося розрізняти, що заслуговує на issue, а що приходить як pull request.

Alex Tutor

Питання 1

Зістав кожну ситуацію з тим, чим вона має стати на GitHub.

Торкніться відповіді, а потім рядка, до якого вона належить. Можна й перетягувати.

Клієнт не може застосувати промокод із телефона
Відділ продажів просить зберігати адреси доставки
До п'ятниці оновити телефон кур'єрської служби у FAQ
Гілка Daniel з кодом, що виправляє баг із промокодом

Відповіді, які ще треба розмістити

Alex Tutor

Issues читають люди, яких не було в кімнаті. Добре issue каже, що не так або чого хочуть, чому це важливо і як ми зрозуміємо, що все готово.

Для фічі це назва, що описує результат, кілька рядків контексту, критерії приймання (acceptance criteria: перевірки, які мають виконуватися, коли роботу завершено) і що не входить у межі задачі.

Ви

А для бага? Сьогоднішній ранковий тест для працівників якраз підкинув ідеальний приклад.

Daniel

Кроки, щоб відтворити, очікуваний результат, фактичний результат і де саме: телефон чи комп'ютер, який акаунт, яке замовлення. Якщо я не можу повторити баг у себе, я не можу його виправити.

Alex Tutor

Спершу контекст. Після того як сьогодні зранку змерджили #156, Daniel увімкнув loyalty-points лише для працівників. Клієнти досі нічого не бачать.

Ви

Замовлення на 600 грн із промокодом на 100 грн, тобто оплачено 500. У кабінеті 60 балів. А має бути 50: один бал за кожні 10 оплачених гривень.

Alex Tutor

Issue #159 у тому вигляді, як його подано

Title: Points counted before promo discount

**Steps to reproduce**
1. Log in with a staff account (flag loyalty-points is on for staff).
2. Add products for 600 UAH to the cart, apply a 100 UAH promo code.
3. Pay 500 UAH by card.
4. Open Account → Loyalty points.

**Expected:** 50 points (1 point per 10 UAH paid).
**Actual:** 60 points, counted from 600 UAH before the discount.

**Where:** desktop, Chrome, staff account, order 58213.
**Screenshot:** the account page showing 60 points.

Issues команда пише англійською, як і коміти. Steps to reproduce: кроки, щоб відтворити. Expected: що мало статися. Actual: що сталося насправді. Where: де саме. Мітки bug і loyalty, виконавець Daniel.

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

Alex Tutor

Питання 2

Підтримка створює issue з назвою «Points broken» і описом «customer says points are wrong, pls fix ASAP». Чого бракує Daniel, щоб почати роботу? Познач усе, що підходить.

Оберіть усі правильні відповідіДедлайну в назві, наприклад «URGENT»Кроків, щоб відтворити: що клієнт робив, по порядкуОчікуваної й фактичної кількості балівЗдогадки, в якому файлі багДе це сталося: пристрій, акаунт, номер замовлення

Ви

А GitHub може змусити всіх писати issues саме так?

Daniel

Може підштовхнути. Сьогодні зранку я відкрив #160 із двома шаблонами issues (issue templates): це файли в репозиторії, у папці .github/ISSUE_TEMPLATE/. Годину тому Oscar його схвалив, тож вони вже працюють.

Alex Tutor

Тепер New issue («нове issue») спершу питає, що саме створюємо: «Bug report», «Feature request» чи порожнє issue (станом на 2026 рік). Шаблон бага починається із заголовків, які ти щойно бачиш, і сам додає мітку bug.

Daniel

Є ще варіант у вигляді форми: окремі поля замість заголовків, і деякі можна зробити обов'язковими. Наші я зробив простими: заголовки й підказка в один рядок під кожним.

Ви

Тобто шаблон дає заголовки. А заповнити їх добре все одно має той, хто пише.

Alex Tutor

Саме так: шаблон може вимагати поле, але не добру відповідь. Спробуй на наступному повідомленні з командного чату.

Alex Tutor

Питання 3Коротка відповідь · Завдання з перевіркою ШІ

Emma пише в командному чаті: «Учора замовила на 450 грн з телефона, акаунт працівника, оплата карткою при отриманні. Сьогодні балів досі 0. Скриншот додаю.» Заповни шаблон «Bug report»: назва, кроки, щоб відтворити, очікуваний і фактичний результат, де саме. Познач, що ще треба уточнити.

Напишіть відповідь і отримайте оцінку та відгук від нашого ШІ-рецензента.

Увійдіть, щоб отримати відгук ШІ

Alex Tutor

Тепер бокова панель праворуч від issue. У ній ті самі поля, що й у pull requests, і вони відповідають на щоденні питання продакта.

Labels («мітки») кажуть, що це за робота і якої частини продукту стосується: bug, content і loyalty, мітка, яку Daniel створив для програми. Відфільтруй список за label:loyalty, і вся програма на одному екрані.

Ви

А Assignees («виконавці»)? У #134 це був Daniel, автор.

Alex Tutor

В issue це той, хто відповідає за те, щоб справа рухалася, а не той, хто його написав. #159 написано тобою, а виконавець Daniel. Можна призначити кількох людей, але одне ім'я одразу показує, кого питати.

Daniel

І міток має бути небагато. Якщо на кожному issue по шість міток, фільтр за будь-якою з них нічого не скаже.

Alex Tutor

Ще два поля, Milestone і Development, сьогодні отримають окремі розділи. А спершу вся панель одним поглядом.

Alex Tutor

Питання 4

Зістав кожне поле в боковій панелі issue з питанням, на яке воно відповідає.

Торкніться відповіді, а потім рядка, до якого вона належить. Можна й перетягувати.

Assignees
Labels
Milestone
Development

Відповіді, які ще треба розмістити

Ви

Повернімося до #147. Програма завелика для одного issue. Відкривати десять окремих?

Alex Tutor

Окремих, так, але пов'язаних. Станом на 2026 рік issue може мати sub-issues (підзадачі): звичайні issues, прикріплені до батьківського. Батьківське показує їхній список і скільки з них закрито, наприклад «1 of 4».

Daniel

Кожне sub-issue це повноцінне issue з власним виконавцем, мітками й станом. Я можу закрити своє, не чіпаючи твого.

Alex Tutor

У старіших репозиторіях щось схоже роблять чеклистом в описі: рядки, що починаються з - [ ], показуються як квадратики для галочок. Це працює, але галочки хтось ставить вручну.

Ви

Отже, #147 стає батьківським: мета і що означає «запущено». А sub-issues це шматки, які люди справді беруть у роботу.

Alex Tutor

Питання 5

Sub-issue це лише рядок тексту в описі батьківського issue, тож власного стану, міток і виконавця в нього немає.

ПравдаНеправда

Alex Tutor

Час переписати #147. Один рядок від CEO має стати батьківським issue, з яким можна працювати. Залиш його думку про Black Friday і додай усе, що він пропустив.

Daniel

З мого боку: #155 і #156 змерджено, а #159 це твій баг. Ще треба зробити баланс у кабінеті й списання балів під час оформлення.

Ви

І #157 від Emma, сторінка програми, досі чернетка. «Запущено» означає, що флаг увімкнено для всіх клієнтів, і це перемикання має бути окремою задачею.

Alex Tutor

Тоді напиши батьківське issue, перелічи sub-issues з відповідальними й мітками та виріши, як на них посилатимуться майлстоун і pull requests.

Alex Tutor

Питання 6Кейс · Завдання з перевіркою ШІ

Перепиши issue #147 як батьківське й сплануй його sub-issues.

Issue #147 минулого тижня відкрив CEO. Назва: «Loyalty». Опис: «Need this before Black Friday!!» Без міток, без виконавця.

Що відомо:

Програма: клієнти отримують 1 бал за кожні 10 грн оплаченого замовлення, бачать баланс в особистому кабінеті й витрачають бали як знижку під час оформлення. Emma пише сторінку з поясненням програми.
Зроблено: #155 «Add loyalty points behind a flag» і #156 «Earn points on paid orders» змерджено, вони сховані за флагом loyalty-points (увімкнено лише для працівників).
Відкрито: issue #159 «Points counted before promo discount» (баг, виконавець Daniel); pull request #157 «Write loyalty programme page» від Emma поки чернетка.
Не почато: баланс в особистому кабінеті; списання балів під час оформлення.
Запуск означає, що флаг увімкнено для всіх клієнтів. Black Friday 27 листопада; команда хоче запуститися щонайменше за два тижні до нього.

Напиши нову назву й опис #147 (мета й контекст, критерії приймання для запуску, що не входить у межі), sub-issues з виконавцем і мітками для кожного, майлстоун (назва й дедлайн) і як pull requests мають посилатися на issues.

Напишіть відповідь і отримайте оцінку та відгук від нашого ШІ-рецензента.

Увійдіть, щоб отримати відгук ШІ

Alex Tutor

Ось до чого дійшла команда. #147 перейменовано, під ним чотири sub-issues, і є майлстоун (milestone): «Loyalty launch», дедлайн 13 листопада.

Майлстоун об'єднує issues і pull requests під однією метою, з необов'язковим дедлайном і смугою прогресу. Мітки відповідають на «що це за робота», а майлстоун на «заради чого і до коли».

Daniel

Я додав туди й #155, #156 і #157. Pull requests теж можуть належати до майлстоуна, а змерджені рахуються як закриті.

Alex Tutor

Майлстоун «Loyalty launch» · Due by November 13GitHub показує «25% complete»: 2 закриті, 6 відкритих.

Launch loyalty points before Black Friday#147
Батьківське · закрито 0 з 4 sub-issues · Sofia
Add loyalty points behind a flag#155
Earn points on paid orders#156
Write loyalty programme page#157
Emma
Points counted before promo discount#159
bug, loyalty · Daniel
Show points balance in the account#162
loyalty · Daniel
Spend points at checkout#163
loyalty · Daniel
Switch on loyalty points for all customers#164
loyalty · Sofia

Ви

Тобто чверть зроблено?

Alex Tutor

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

Ви

Отже, читаю список під смугою, а не лише відсоток.

Alex Tutor

Питання 7

Що показує смуга прогресу цього майлстоуна?

Усі елементи майлстоуна «Gift wrap»

Add gift wrap option
Gift wrap price in the cart
Gift wrap for bundles
Gift wrap photo on product page
Gift wrap in three colours
Show gift wrap in past orders
Gift wrap copy for checkout
Gift wrap in order emails
Gift wrap on the invoice
Gift wrap for gift cards

Оберіть одну відповідь50%: рахується лише завершена робота40%: pull requests у майлстоуні не рахуються60%: закрито шість елементів із десяти, включно з незапланованим70%: відкритий pull request рахується як наполовину зроблений

Alex Tutor

Вівторок зранку. Daniel відкриває #165, виправлення твого бага. Ключові слова закриття вже траплялися тобі на #134; сьогодні подивимося на них з боку issue, коли є ще й батьківське.

Daniel

Я почав просто з issue. У розділі Development («розробка») в #159 є Create a branch («створити гілку»). GitHub пропонує назву з номера й назви issue; я змінив її за нашою звичкою на fix/points-after-discount.

Alex Tutor

Від issue #159 до mainГілку створено просто з issue, тож #159 показує її в розділі Development. Коли #165 змерджать через squash, його коміт у main закриє #159.

e5f81a3Hide loyalty menu link when flag is off (#158)v1.4.1
b2e6f10Earn points on paid orders (#156)
6e0b4d8Add issue templates (#160)
4f8c2e1Count points from the paid amountfix/points-after-discount
7a1d9c3Count points after discounts (#165)main

В описі #165 є два посилання, які схожі на вигляд, але поводяться по-різному.

Alex Tutor

Розділ «Why» в #165

## Why
Fixes #159. Part of #147.
Points were counted from the order total before promo codes.

Fixes #159: ключове слово закриття. Part of #147: просто згадка.

Ви

Fixes #159 закриє баг, коли #165 змерджать у main. А Part of #147 лише згадка?

Alex Tutor

Так. Просте #147 створює перехресне посилання: у хронології #147 з'явиться запис, що #165 його згадав, і нічого не закриється. Закриває лише close, fix чи resolve перед номером, і тільки після мерджу в основну гілку.

Daniel

Саме тому я ніколи не пишу Fixes #147 в одному зі шматків. Перший же змерджений шматок закрив би всю програму.

Alex Tutor

І ще одна пастка: кожен номер потребує власного ключового слова. «Fixes #159 and #162» закриє лише #159. Треба писати «Fixes #159, fixes #162».

Alex Tutor

Питання 8

Наступний pull request від Daniel, #166, має в описі: «Fixes #162. Related to #163 and #147.» Його схвалюють і зливають у main через squash. Які issues закриє GitHub?

Оберіть одну відповідь#162, #163 і #147Жодного: issues закривають лише вручну#162 і #163Лише #162

Ви

Після мерджу в #159 фіолетова іконка: закрито як виконане, автоматично.

Alex Tutor

А Development зберігає посилання на #165, тож кожен бачить, що саме його закрило і коли. Якщо виправлення не спрацює, issue можна знову відкрити.

Daniel

Тест для працівників після обіду пройшов: оплачено 500 грн, 50 балів. Тож у коді на сайті баг виправлено, хоча клієнти балів досі взагалі не бачать.

Alex Tutor

Не змішуй ці дві речі у звітах. Стан issue каже, що роботу зроблено; флаг каже, хто її бачить.

Alex Tutor

Питання 9

Підтримка питає: «Клієнт чув про бали лояльності. Баг із балами для клієнтів уже виправлено?» Флаг loyalty-points досі увімкнено лише для працівників. Яка відповідь точна?

#159 і #165 у вівторок після обіду

Points counted before promo discount#159
Закрито через #165
Count points after discounts#165
Змерджено в main · deploy (production) завершено

Оберіть одну відповідьТак: #159 закрито, тож клієнти тепер отримують правильну кількість балівВиправлення вже в коді на сайті, але в клієнтів балів лояльності ще немає: програму ввімкнено лише для працівниківНі: #165 змерджено, але викладуть його лише завтраНі, доки не опублікують сторінку наступного релізу

Ось такий GitHub з боку issues: чітко описана проблема, відповідальний і кілька міток, батьківське issue з sub-issues, майлстоун із датою і pull requests, які закривають рівно те, що виправляють.

Ви

Майлстоун каже, скільки елементів закрито. Але не каже, хто над чим працює просто зараз.

Daniel

Для цього потрібна дошка. Завтра я волів би перетягувати свої картки, а не писати повідомлення про статус.

Alex Tutor

Тоді наступний урок: дошка проєкту, яка веде бали лояльності від першого issue до дня, коли їх побачать клієнти.

Alex Tutor

На цьому все. Ви відповіли на всі завдання — чудова робота.

Наступний урок: Дошки проєктів: як провести фічу до релізу