Атомарні коміти

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

Переваги

• Легше зрозуміти: атомарний коміт зосереджений на одній логічній зміні, тому іншим (і тобі в майбутньому) простіше зрозуміти призначення та вплив кожного коміту.
• Простіше налагодження: коли в код проникає помилка, атомарні коміти допомагають точно знайти коміт, який її спричинив, бо кожен коміт — самодостатня зміна.
• Краща командна робота: колегам простіше переглядати конкретні зміни й давати зауваження, бо кожен коміт присвячений одному завданню чи виправленню.
• Чистіша історія: з атомарними комітами історія проєкту залишається чистою й упорядкованою — нею легше рухатися й розуміти, як розвивався код.
• Простіше скасовувати зміни: якщо конкретну зміну треба скасувати, атомарні коміти дозволяють зробити це, не зачіпаючи інші, ніяк не пов'язані зміни, і ризик нових проблем мінімальний.
• Зручніший cherry-pick: атомарні коміти легше переносити між гілками через cherry-pick, бо кожен коміт — самодостатня одиниця роботи.

Підводні камені

Якщо перестаратися, атомарні коміти можуть вийти боком:

• Надмірне дроблення: якщо розбивати зміни занадто дрібно, вийде купа крихітних комітів, за якими важко стежити й міркувати про них.
• Втрата контексту: за маленькими ізольованими змінами може загубитися загальна картина всієї функції чи виправлення.
• Більше рутини: багато дрібних комітів — це додатковий час на коміти, пуші та, можливо, кілька окремих пулл реквестів.
• Складніші відкати: якщо функція складається з кількох атомарних комітів, а її треба скасувати, зробити це чисто буде важче.
• Гірша читабельність: повна історія однієї зміни може розтягтися на багато комітів, і іншим розробникам буде складніше зрозуміти її, читаючи історію.

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