Як редагувати файл на GitHub і зробити revert PR

Alex Tutor

Середа четвертого тижня. Підтримка втретє пересилає ту саму нотатку від клієнта: на сторінці доставки написано, що кур'єри телефонують «30 minutes before arival».

Ви

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

Daniel

Будь ласка. Це текст на сторінці, а тексти сторінок належать тобі й Emma. Я перегляну це, як будь-який інший pull request.

Alex Tutor

Перш ніж клікати, визначимо межу. Продакт може спокійно редагувати тексти й документацію: тексти сторінок у файлах .md, FAQ, README, шаблони issues. І все це однаково проходить через pull request.

Daniel

Код і конфігурація лишаються за інженерами: файли .tsx, config/prices.json, усе в .github/workflows/. Одна пропущена кома в конфігураційному файлі може зупинити збирання всього сайту.

Ви

Навіть попри те, що ціна в config/prices.json це просто число?

Daniel

Навіть тоді. Код читає це число під час оформлення. Попроси про зміну, і я зроблю її з тестами й рев'ю від Oscar, як поріг у #133.

Alex Tutor

Питання 1

Які з цих змін Sofia може зробити власноруч у браузері, через pull request? Познач усе, що підходить.

Оберіть усі правильні відповідіВиправити одрук у pages/delivery.mdЗмінити freeDeliveryFrom у config/prices.jsonОновити відповідь у pages/faq/delivery.mdПідправити логіку кнопки в components/CheckoutButton.tsxДодати підказку в шаблон звіту про баг у .github/ISSUE_TEMPLATE/Змінити задачу деплою в .github/workflows/

Alex Tutor

Почни зі сторінки репозиторію, вкладка Code. Відкрий папку pages, а в ній delivery.md. Або натисни t і набери «delivery», щоб шукати за назвою файлу.

Ви

Є. Рядок 15: «Couriers call 30 minutes before arival.» А перемикач гілок над файлом показує main.

Alex Tutor

Угорі праворуч над файлом є іконка олівця, Edit this file («редагувати цей файл») станом на 2026 рік. Вона відкриває вебредактор GitHub просто в браузері.

Daniel

Поки друкуєш, нічого не зберігається й нічого не може зламатися. Доки немає коміту, редактор це лише чернетка у вкладці твого браузера.

Alex Tutor

Виправ слово, а тоді відкрий вкладку Preview («попередній перегляд»), щоб побачити текст таким, як він виглядатиме на сторінці, а не сирим Markdown.

Alex Tutor

Правка в `pages/delivery.md`

 Couriers deliver within one day in Kyiv.
-Couriers call 30 minutes before arival.
+Couriers call 30 minutes before arrival.

Змінилося одне слово, тож Git показує весь рядок двічі: стару версію видалено, нову додано.

Alex Tutor

Питання 2

Натискання іконки олівця на файлі в main одразу створює нову гілку, і кожне натискання клавіші в неї зберігається.

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

Alex Tutor

Тепер зелена кнопка Commit changes… («закомітити зміни»). Відкривається вікно з повідомленням коміту, необов'язковим розширеним описом і вибором, куди піде коміт.

Ви

У полі повідомлення вже написано «Update delivery.md».

Daniel

Це стандартний текст GitHub. Правдивий і марний в історії з двох тисяч комітів. Напиши, що змінилося: «Fix typo in courier note».

Alex Tutor

Тепер вибір. «Commit directly to the main branch» («закомітити просто в main») тобі недоступне: захист гілки пускає зміни в main лише через pull requests. Тож обирай «Create a new branch for this commit and start a pull request» («створити нову гілку для цього коміту й почати pull request»).

Daniel

GitHub пропонує назву на кшталт catchow-sofia-patch-1. Вона працюватиме, але перейменуй за нашою звичкою: content/delivery-typo.

Ви

Далі Propose changes («запропонувати зміни»). Коміт потрапляє в нову гілку, а main зовсім не змінилася.

Alex Tutor

Питання 3

Чому коміт Sofia йде в нову гілку, а не просто в main?

Оберіть одну відповідьВебредактор ніколи не може комітити в main, у жодному репозиторіїmain захищена: зміни потрапляють у неї лише через pull request, після рев'ю й перевірокВиправлення одруків мають чекати на четверговий релізАкаунту Sofia не дозволено створювати коміти

Alex Tutor

Propose changes веде на сторінку «Open a pull request»: base main, compare content/delivery-typo. Назва береться з повідомлення коміту, а опис пишеш ти.

Ви

What: виправлено «arival» на сторінці доставки. Why: підтримка пересилала це тричі. How to test: відкрити preview й прочитати рядок про кур'єрів. Рев'юер: Daniel.

Alex Tutor

Потім Create pull request. Це #168, і перевірки стартують одразу: build, test і preview з власним посиланням.

Daniel

До речі, схвалити власний pull request не вийде. GitHub не дає авторам схвалювати свої зміни, тож наше «одне схвалення» завжди означає, що подивився хтось інший.

Alex Tutor

Поки йдуть перевірки, Emma помічає pull request і просить додати ще один рядок під нотаткою про кур'єрів: «Earn loyalty points on every order and spend them at checkout.»

Ви

Той самий файл, та сама гілка. Відкриваю delivery.md у content/delivery-typo, додаю її рядок і комічу просто в цю гілку: «Mention loyalty points on delivery page».

Daniel

Нова назва, «Fix courier typo and mention loyalty points». Перевірки зелені, у preview усе читається добре. Схвалено.

Alex Tutor

Ти натискаєш Squash and merge: один коміт у main, гілку видалено, а деплой завершується за чотири хвилини.

Alex Tutor

Pull request #168, середа, 11:20

Fix courier typo and mention loyalty points#168
Злито в main через squash · мердж: Sofia · гілку content/delivery-typo видалено
Daniel
Схвалено
build
test
preview
deploy (production)
Завершився за чотири хвилини після мерджу

Alex Tutor

Питання 4

Розстав по порядку кроки зміни, зробленої в браузері: від відкриття файлу до живої сторінки.

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

Ви

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

Alex Tutor

Сторінка програми від Emma схована за флагом loyalty-points; Daniel вбудував цю перевірку в #157. А речення в pages/delivery.md жодного флагу навколо не має. Змерджено й викладено означає показано.

Daniel

Та сама помилка, що з моїм посиланням у меню перед v1.4.1: фічу приховали, а один вхід до неї ні. І на рев'ю я цього теж не помітив.

Ви

Тобто ми анонсуємо бали лояльності за шість днів до запуску. Як це забрати назад?

Alex Tutor

Питання 5

Чому клієнти бачать рядок про лояльність на сторінці доставки, хоча флаг loyalty-points вимкнений?

Оберіть одну відповідьФлаг сам вмикається, коли сторінка згадує його фічуSquash-мердж вмикає всі флагиДеплой пропускає перевірки флагів для текстових файлівРечення це звичайний текст сторінки без перевірки флагу, тож після мерджу й деплою його бачать усі

Alex Tutor

Відкрий #168. Унизу вкладки Conversation, поруч із позначкою, що його змерджено, є кнопка Revert (станом на 2026 рік).

Revert (відкат) нічого не видаляє. GitHub створює нову гілку revert-168-content/delivery-typo з одним комітом, який робить рівно протилежне до #168, і готує для неї pull request.

Daniel

Це #169, і для нього діють ті самі правила, що й для будь-якого pull request: перевірки й одне схвалення. Скасування зміни це теж зміна. Вже дивлюся.

Ви

Схвалено, перевірки зелені, злито через squash, викладено. Рядка про лояльність немає. А разом із ним і мого виправлення: «arival» повернулося.

Alex Tutor

Бо #168 став одним squash-комітом з обома змінами, а revert скасовує коміт цілком. Історія зберігає все: твій коміт, revert і хто що зробив.

Alex Tutor

Зміна та її revert у mainНічого не зникає: revert це новий коміт, який скасовує f3c8d21. Обидва лишаються в історії, а #168 і далі показує Merged.

c3f7a05Show points balance in the account (#166)v1.5.0
8d2b6e9Write loyalty programme page (#157)
5e9a1b4Fix typo in courier note
1a7c4f2Mention loyalty points on delivery pagecontent/delivery-typo
f3c8d21Fix courier typo and mention loyalty points (#168)
a6b0e53Revert "Fix courier typo and mention loyalty points"revert-168-content/delivery-typo
d7e2f48Revert "Fix courier typo and mention loyalty points" (#169)main

Alex Tutor

Питання 6

Кожен коміт у цій main уже викладено. Які зміни зараз на сайті?

main іншого магазину, найновіше внизу

a1Update shipping FAQ
a2Add spring sale banner
a3Change footer phone number
a4Revert "Add spring sale banner"main

Оберіть одну відповідьУсі три зміни, бо revert ніколи нічого не прибираєЛише оновлений FAQ про доставку: revert скасовує ще й усе, що було після скасованого комітуОновлений FAQ про доставку й новий телефон у футері; банера немає, хоча його коміт a2 досі в історіїЖодної: revert повертає main до першого коміту

Ви

А хіба не можна було просто видалити рядок про лояльність новим pull request?

Alex Tutor

Можна: це виправлення вперед (fix forward), нова зміна, яка виправляє проблему. Вона зберегла б твоє виправлення одруку. Обидва шляхи нормальні; питання в тому, який швидше й безпечніше поверне сайт до ладу.

Daniel

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

Alex Tutor

І кнопка спрацьовує не завжди. Якщо пізніші зміни зачепили ті самі рядки, GitHub не зможе сам зібрати revert, і його робить інженер вручну.

Daniel

А ще revert коду не скасовує того, що вже сталося. Якщо через баг клієнти отримали неправильні бали, revert зупинить нові, але виправлення їхніх балансів потребує плану, а не кнопки.

Ви

Тут рядок був обіцянкою, яку ми ще не можемо виконати, а одрук ще годину нікому не зашкодить. Почати з revert було нормально.

Alex Tutor

Питання 7

Зістав кожну ситуацію після мерджу з кращим способом її виправити.

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

Змерджений банер показує неправильні дати розпродажу, а правильні ще уточнюють
У змердженій відповіді FAQ одне неправильне число, а правильне відоме
Останній мердж зламав оформлення замовлення для всіх, а причина незрозуміла
Великий pull request з п'ятьма добрими змінами має одну дрібну помилку в тексті

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

Ви

Тоді #170: гілка content/courier-typo, один коміт «Fix typo in courier note», така сама назва. Лише одрук.

Daniel

Схвалено. А рядок про лояльність отримає окремий pull request, готовий до мерджу 10 листопада, того ранку, коли флаг увімкнуть для всіх.

Alex Tutor

І ще одне: Emma варто знати, чому її рядок зник. Вона попросила про нього з добрих намірів, і за шість днів захоче його повернути.

Ви

Тоді два-три речення в командному чаті.

Alex Tutor

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

Напиши Emma повідомлення в чат у 2–3 реченнях: чому її рядок про лояльність прибрали зі сторінки доставки, що зараз на сайті, і коли та як рядок повернеться. Запуск (флаг для всіх клієнтів) 10 листопада.

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

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

Alex Tutor

Якщо хочеш потренуватися, створи особистий репозиторій для практики або пройди безплатний курс GitHub Skills «Introduction to GitHub». Жоден клік там не дістанеться до справжнього сайту.

Ви

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

Daniel

Усі вчаться, щось ламаючи. Хитрість у тому, щоб ламати в pull request, де це легко скасувати.

Alex Tutor

Тоді останнє завдання курсу: сплануй зміну так, як зробиш це в понеділок, від першого кліку до плану скасування.

Alex Tutor

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

Сплануй зміну для issue #175 від початку до кінця.

Підтримка відкрила issue #175 «Returns FAQ still says 14 days». Фінансовий відділ підтвердив в issue: з понеділка клієнти можуть повернути нерозпечатаний корм протягом 30 днів замість 14.

pages/faq/returns.md, рядок 8: «You can return unopened food within 14 days.»
config/returns.json: "returnWindowDays": 14. Оформлення замовлень читає це значення, щоб приймати чи відхиляти повернення в особистому кабінеті клієнта.

main захищена (лише pull requests, 1 схвалення, перевірки build і test); кожен мердж викладають за кілька хвилин; команда зливає через squash; гілки називають content/… і fix/….

Напиши план: що редагуєш власноруч, а що передаєш інженерам; кроки в браузері; назву гілки й повідомлення коміту; назву й опис pull request, зокрема як він пов'язаний з #175; хто переглядає і що ти перевіряєш до й після мерджу; і план скасування, якщо щось піде не так.

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

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

Alex Tutor

Вівторок, 10 листопада, 9:00. Флаг loyalty-points вмикають для всіх клієнтів, а за хвилину рядок Emma повертається на сторінку доставки окремим pull request. Ти закриваєш #147 як виконане.

Ви

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

Daniel

І тепер у тебе є власна історія з revert. Ласкаво просимо в історію команди.

Alex Tutor

Ось і весь курс: історія й diff, гілки й мерджі, pull requests і рев'ю, стани, воркфлоу й релізи, issues і дошки, а тепер і власна зміна. Репозиторій більше не чорна скринька. Це спільна пам'ять команди, і ти теж можеш у ній писати.

Alex Tutor

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

Назад до курсу