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