Практика пулл реквестів
TL;DR: у GitByBit тепер можна потренуватися створювати пулл реквести!
Бувало таке? Знаходиш помилку в чужому коді й думаєш: «Чому це досі не виправили?» Створюєш тикет, чекаєш... і нічого.
Так от: чекати більше не обов'язково.
Можна закасати рукави й виправити все самотужки. Надішли пулл реквест, дочекайся злиття — і твоєю роботою користуватимуться всі, хто працює з цією бібліотекою.
Ніколи не знаєш, що витягнеш із пулл реквеста.
Справжня помилка, справжнє виправлення
Практика починається з життєвого сценарію: твій фітнес-трекер глючить, коли хтось намагається записати активність на полі для гольфу з дистанцією в ярдах. Застосунок не вміє конвертувати ярди в метри й падає. Виправлення просте — додати конвертацію (1 ярд = 0,9144 метра). Латаєш бібліотеку й спокійно живеш далі.
Але за якийсь час прилітає оновлення, яке ламає твоє виправлення. Доводиться накладати латку знову. Потім ще раз. І ще. Стає ясно: час іде на безглузде латання, а виправлення має жити в самій бібліотеці. Як же його туди доправити?
Могутній пулл реквест
Більшість проєктів із відкритим кодом розміщені на GitHub або схожих платформах, і всі вони підтримують пулл реквести. Пулл реквест — це спосіб запропонувати зміни до проєкту. Ти робиш форк репозиторію, вносиш зміни, а потім надсилаєш до оригінального репозиторію пулл реквест із пропозицією злити твої правки в основну кодову базу.
Окрім технічного боку (форків, гілок і злиттів), пулл реквест передбачає ще й спілкування. Треба пояснити, що саме змінено, навіщо ці правки потрібні і як вони покращують проєкт. Саме тут можна показати, наскільки добре ти розумієш кодову базу і вмієш робити корисний внесок. Але нічого не вийде, якщо запороти пулл реквест недбалими повідомленнями комітів, запушити купу сторонніх правок або знехтувати правилами проєкту щодо внесення змін.
З таким настроєм у коментарях до пулл реквеста далеко не заїдеш.
До того ж під час обговорення пулл реквеста, можливо, доведеться оновлювати форк, робити ребейз і розв'язувати конфлікти. Усе це вимагає цілого набору Git-навичок, і тепер усі їх можна відпрацювати в GitByBit у реалістичному сценарії зі справжніми репозиторіями на GitHub.
Щоб довести пулл реквест до пуття, потрібно чимало терпіння та уваги до деталей.
Разом із практикою пулл реквестів я додав до Gitопедії кілька нових статей, зокрема і . А ще з'явилися дві нові найкращі практики: та .
