Семантичне версіонування: теги й релізи на GitHub

Ви

Підтримка хоче писати клієнтам «виправлено у версії така-то», як у нотатках до оновлень застосунків. Яка версія була в #134?

Daniel

Чесна відповідь: жодної. Глянь на сторінку Tags («теги»). Там чотири старі теги, від v1.0.0 до v1.3.0, я ставив їх вручну для великих запусків. Останній стоїть на наборі ласощів.

Alex Tutor

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

Alex Tutor

main і її єдиний свіжий тегv1.3.0 позначає 8be2f70. Усе, що змерджили після нього, зокрема #134, уже на сайті, але не входить у жодну версію.

8be2f70Add cat treats bundlev1.3.0
6f2c8a1Raise free-delivery threshold to 1000 UAH (#133)
a7d93e4Rewrite delivery page copy (#132)
d51c7e8Fix checkout button after cart edits (#134)
3b8e1f6Add autumn sale banner (#136)
9c4a2d7Add loyalty points behind a flag (#155)main

Ви

Тобто тег це як закладка в історії, а main пішла від неї на п'ять комітів уперед.

Daniel

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

Alex Tutor

Тож відсьогодні команда щочетверга робить реліз: поточна main, яка вже на сайті, отримує номер версії й нотатки. Термінові виправлення отримують власну версію одразу.

Alex Tutor

Питання 1

Підтримка питає: «Виправлення кнопки, #134, вийшло у v1.3.0?» Яка правильна відповідь у четвер зранку?

main у четвер зранку

8be2f70v1.3.0
6f2c8a1#133
a7d93e4#132
d51c7e8#134
3b8e1f6#136
9c4a2d7#155main

Оберіть одну відповідьТак: v1.3.0 найновіший тег, тож він містить усе, що є в mainНі: v1.3.0 вказує на 8be2f70, а #134 з'явився пізніше; поки його не містить жоден тегТак: тег рухається разом із main, доки не створять наступнийНі: #134 ще не на сайті

Ви

Чому v1.3.0, а не просто «версія 13»?

Alex Tutor

Це семантичне версіонування, SemVer: MAJOR.MINOR.PATCH. Кожне число каже, яка зміна відбулася. PATCH зростає для виправлень, MINOR для нових можливостей, які нічого не ламають, MAJOR для змін, що ламають щось, на що люди покладаються.

Коли число зростає, усі праворуч від нього обнуляються. Після 1.3.0 виправлення дає 1.3.1, нова можливість 1.4.0, несумісна зміна 2.0.0.

Daniel

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

Ви

А v на початку?

Daniel

Просто поширена звичка для назв тегів. Сама версія це 1.3.0. Іноді ще побачиш 2.0.0-beta.1: це пре-реліз, тестова версія, яка передує справжній 2.0.0.

Alex Tutor

Питання 2

Останній реліз v1.4.0. Зістав кожен наступний реліз із версією, яку він має отримати за правилами Котокорму.

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

Лише виправлення хибного посилання у футері
Нове поле для листівки до подарунка під час оформлення
Нові адреси сторінок; усі старі посилання на товари перестають працювати
Тестова збірка нового каталогу перед справжнім релізом

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

Ви

Одну пастку я вже бачу: 1.4.10 старша за 1.4.9? За абеткою так і було б.

Alex Tutor

Кожна частина це ціле число, і порівнюють їх зліва направо. Десять більше за дев'ять, тож 1.4.10 новіша. А пре-реліз старший за свій реліз: 1.5.0-beta.1 іде перед 1.5.0.

Daniel

До речі, на сторінці тегів GitHub не завжди сортує їх саме так. Довіряй числам, а не порядку в списку.

Ви

Числа, а не абетка. Зрозуміло.

Alex Tutor

Питання 3

Розстав ці версії від найстарішої до найновішої.

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

Alex Tutor

Четвер, після обіду. Від v1.3.0 додалися дві нові можливості, банер розпродажу й прихована основа для балів лояльності, тож це MINOR-реліз: v1.4.0. Daniel відкриває Releases («релізи») зі сторінки репозиторію.

Daniel

Станом на 2026 рік: Draft a new release («створити чернетку релізу»), вводжу v1.4.0 як новий тег, ціль main. GitHub створить тег під час публікації. Попередній тег v1.3.0, а тоді чарівна кнопка: Generate release notes («згенерувати нотатки до релізу»).

Alex Tutor

Що згенерувала кнопка Generate release notes

## What's Changed
* Raise free-delivery threshold to 1000 UAH by @catchow-daniel in https://github.com/catchow/website/pull/133
* Rewrite delivery page copy by @catchow-emma in https://github.com/catchow/website/pull/132
* Fix checkout button after cart edits by @catchow-daniel in https://github.com/catchow/website/pull/134
* Add autumn sale banner by @catchow-emma in https://github.com/catchow/website/pull/136
* Add loyalty points behind a flag by @catchow-daniel in https://github.com/catchow/website/pull/155

**Full Changelog**: https://github.com/catchow/website/compare/v1.3.0...v1.4.0

GitHub генерує нотатки англійською: «What's Changed» (що змінилося) і по рядку на кожен змерджений pull request від попереднього тегу, з автором і посиланням. «Full Changelog» веде на порівняння двох тегів.

Ви

Кожен змерджений pull request від v1.3.0, з назвою й автором. Тож добрі назви окупаються двічі.

Alex Tutor

Під текстом є місце для файлів, assets («ресурси»). GitHub завжди сам додає вихідний код архівами zip і tar.gz; команди застосунків прикладають зібраний застосунок. Нам більше нічого не треба.

Daniel

Далі два прапорці. Set as a pre-release («позначити як пре-реліз») для тестових версій; сьогодні ні. Set as the latest release («позначити як останній реліз»): так. Publish release, і сторінка репозиторію показує v1.4.0 із зеленою позначкою Latest.

Alex Tutor

Два найновіші теги в catchow/website, четвер увечері

v1.4.0
Latest · на 9c4a2d7 · нотатки від Daniel і Sofia
v1.3.0
на 8be2f70 · без сторінки релізу, лише тег

Alex Tutor

Питання 4

Які твердження про новий реліз v1.4.0 у Котокормі правильні? Познач усе, що підходить.

Оберіть усі правильні відповідіСторінка релізу побудована на тезі v1.4.0, що вказує на 9c4a2d7Публікація релізу виклала зміни на сайтЗгенеровані нотатки перелічують pull requests, змерджені після v1.3.0Latest означає, що це найновіша версія, яка не є пре-релізом, а не що її щойно викладеноv1.3.0 тепер указує на той самий коміт, що й v1.4.0

Ви

Підтримка не зрозуміє «Add loyalty points behind a flag». І їм точно не можна поки що розповідати клієнтам про бали лояльності.

Alex Tutor

У цьому різниця між списком pull requests і changelog: записом змін у кожній версії, написаним для тих, хто цим користується. Згенерований список це сировина, а не готовий текст.

Daniel

Деякі команди ведуть файл CHANGELOG.md із розділами на кшталт Added, Changed, Fixed. Нашим changelog будуть сторінки релізів. А ще я додам невеликий конфіг, щоб генератор групував pull requests за мітками: bug у розділ «Fixes».

Alex Tutor

Тож над згенерованим списком з'являється коротка частина «Для клієнтів і підтримки» простими словами, а сам список лишається нижче для інженерів.

Ви

Що помітять клієнти, що має казати підтримка, і ні слова про приховану роботу.

Alex Tutor

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

Напиши частину «Для клієнтів і підтримки» нотаток до v1.4.0 (3–5 коротких рядків) на основі згенерованого списку вище. Бали лояльності анонсувати поки не можна.

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

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

Ви

Стривай. #134 з'явився на сайті минулої середи, а «випустили» його сьогодні. Тобто в Котокормі реліз настає тоді, коли клієнти вже мають зміну?

Alex Tutor

Так. У нас «змерджено» означає «на сайті за кілька хвилин», а реліз це названий знімок, про який людям зручно говорити. Три слова, але в Котокормі два з них зазвичай стаються одночасно.

Daniel

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

Alex Tutor

А флаги відокремлюють «випущено» від «видно» навіть у нас. #155 входить у v1.4.0, але жоден клієнт його не бачить.

Ви

Тож коли мене питають «це вже працює?», я спершу питаю себе: змерджено, випущено чи видно клієнтам?

Alex Tutor

Питання 6

Зістав кожну ситуацію з тим, що клієнти мають насправді.

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

#134 у Котокормі, змерджено минулої середи, входить у v1.4.0 з четверга
#155 у Котокормі, входить у v1.4.0, флаг loyalty-points вимкнено
Нагадування в застосунку v2.8.0, схвалено, 2-й день поступового розгортання
Цілі за кроками вчора змерджили в develop застосунку

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

Ви

Підтримка щойно переслала два повідомлення. Клієнти бачать у меню особистого кабінету нове посилання «Бали лояльності», і воно відкриває порожню сторінку.

Daniel

Моя помилка. У #155 розділ лояльності перевіряє флаг, а посилання в меню ні. Його видно з вівторка. Виправлення на два рядки.

Alex Tutor

Це хотфікс: термінове виправлення того, що клієнти вже мають. У GitHub flow це не окремий тип гілки, а просто малий pull request у main, який іде поза чергою.

Daniel

Після v1.4.0 нічого більше не мерджили, тож після виправлення main це v1.4.0 плюс одне виправлення. Якби туди проскочила нова можливість, чесно було б назвати це v1.5.0.

Alex Tutor

Сплануй це, поки Daniel не почав: шлях до сайту, версію, нотатки і що підтримка скаже двом клієнтам.

Alex Tutor

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

Сплануй хотфікс для посилання на бали лояльності в меню і напиши нотатки до його релізу.

П'ятниця, 10:00. Відколи у вівторок виклали #155, клієнти бачать у меню кабінету посилання «Бали лояльності», яке відкриває порожню сторінку. Програму не анонсували; флаг loyalty-points вимкнено, але посилання в меню його ігнорує. v1.4.0 опублікували вчора, і він позначений як Latest; відтоді нічого не мерджили.

Котокорм працює за GitHub flow: main захищена (pull request, щонайменше одне схвалення, обов'язкові перевірки build і test, актуальна гілка), кожен pull request отримує preview, а кожен мердж у main викладають за кілька хвилин.

Напиши: (1) кроки від гілки до «виправлено на живому сайті», хто що робить; (2) номер версії й чому; (3) короткі нотатки до релізу для підтримки; (4) що підтримка скаже двом клієнтам.

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

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

Daniel

Готово до 11:30. #158 «Hide loyalty menu link when flag is off», Oscar схвалив, preview подивилися і ти, і Oscar, змерджено через squash як e5f81a3, викладено. v1.4.1 опубліковано, і тепер позначка Latest на ньому.

Ви

Закладаюся, наступне питання підтримки: чи є виправлення кнопки і в v1.4.1? У його нотатках його немає.

Alex Tutor

main із двома новими тегамиКожен тег позначає один коміт. v1.4.1 стоїть далі на тій самій лінії, тож містить усе з v1.4.0 плюс e5f81a3.

8be2f70Add cat treats bundlev1.3.0
6f2c8a1Raise free-delivery threshold to 1000 UAH (#133)
a7d93e4Rewrite delivery page copy (#132)
d51c7e8Fix checkout button after cart edits (#134)
3b8e1f6Add autumn sale banner (#136)
9c4a2d7Add loyalty points behind a flag (#155)v1.4.0
0d7b3c9Check flag before showing menu linkfix/loyalty-menu-link
e5f81a3Hide loyalty menu link when flag is off (#158)mainv1.4.1

Нотатки до релізу перелічують лише нове від попередньої версії. Але версія містить усе, що було до неї на тій самій лінії. v1.4.1 пізніша за v1.4.0, а v1.4.0 містить d51c7e8.

Daniel

Довести це на GitHub можна двома способами. Порівняння v1.4.0...v1.4.1 показує, що саме додалося між тегами: один коміт. А станом на 2026 рік сторінка коміту перелічує теги, які його містять.

Ви

Тож на d51c7e8 я побачу і v1.4.0, і v1.4.1, але не v1.3.0.

Alex Tutor

Саме так. Цю відповідь підтримка може пересилати: «виправлено у 1.4.0 і в кожній версії після неї».

Alex Tutor

Питання 8

Daniel відкриває порівняння v1.4.0...v1.4.1. Які pull requests воно покаже?

Між двома тегами

d51c7e8#134
3b8e1f6#136
9c4a2d7#155v1.4.0
e5f81a3#158mainv1.4.1

Оберіть одну відповідь#134, #136, #155 і #158#155 і #158Жодного: обидва теги на одній гілціЛише #158

Ви

А якщо в мене є лише сторінки релізів?

Alex Tutor

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

Daniel

Це «хіба що» важливе. Згадай мій березневий revert: пізніша версія може щось і забрати.

Ви

Отже, перша поява плюс жодного revert після неї. Добре.

Alex Tutor

Питання 9

Підтримка питає: «Чи є виправлення кнопки #134 у v1.4.1?» Які способи перевірки дають надійну відповідь? Познач усе, що підходить.

Оберіть усі правильні відповідіВідкрити сторінку коміту d51c7e8 і подивитися, які теги його містятьШукати #134 лише в нотатках до v1.4.1Знайти #134 у нотатках до v1.4.0, а потім перевірити, що жоден пізніший реліз його не відкочуєПеревірити, чи #134 має стан MergedПереглянути історію main до коміту з тегом v1.4.1

Це модуль 4: GitHub flow у нас, git flow там, де реліз це подія, і версії, завдяки яким на питання «це вже працює, і в якій версії?» є відповідь в один рядок.

Ви

А тепер балам лояльності потрібне місце, де вся команда бачить, що лишилося до запуску.

Daniel

Issues, мітки, майлстоун і дошка проєкту. Це наступний модуль, і там ти власноруч зробиш свою першу зміну.

Alex Tutor

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

Наступний урок: Issues, мітки й майлстоуни; зв'язок PR з issues