diff
Також називають: різниця, дифф
Перегляд того, що змінилося між двома версіями: видалені рядки червоні з мінусом, додані зелені з плюсом.
Diff відповідає на питання «що саме змінилося?». Він порівнює дві версії рядок за рядком: видалені рядки червоні з мінусом, додані зелені з плюсом, а кілька незмінених рядків навколо дають контекст. Змінений рядок виглядає як одне видалення й одне додавання. GitHub показує diff на сторінці кожного коміту і у вкладці Files changed у pull request; режим split ставить стару й нову версії поруч.
Приклад
Diff коміту Daniel a41c09e показує один червоний рядок "delivery": 49 і один зелений "delivery": 59 у config/prices.json.
Типові помилки
Читати лише рядки diff і не помічати того, чого в ньому немає: зміна ціни без відповідної правки тексту FAQ це прогалина, яку видно, лише якщо подумати, що ще мало змінитися.
Вивчити в курсі
- Читаємо історію: повідомлення, diff і blame · Як відкрити історію файлу, прочитати diff рядок за рядком і через blame простежити будь-який рядок до його коміту, pull request та issue.
- Рев'ю pull request очима PM: коментарі, пропозиції, approve · Що продакт перевіряє в pull request, а що лишає інженерам, як коментувати рядок, пропонувати зміни з точним формулюванням, вирішувати, коли схвалити pull request, а коли попросити змін, і писати коментарі до рев'ю, які приємно отримувати.
- Репозиторій і коміти: як читати сторінку репозиторію · Що таке репозиторій на GitHub, його сторінка згори донизу, що розповідає окремий коміт і яким має бути добре повідомлення коміту.
- Що таке pull request: анатомія сторінки PR · Що таке pull request, згори донизу: базова гілка й гілка змін, чернетка і готовий PR, чотири вкладки, опис і шаблон pull request, рев'юери й мітки, пов'язані issues, перевірки й блок мерджу.
- Перша зміна в браузері і як її відкотити через revert · Невелика зміна повністю у вебінтерфейсі GitHub: знайти файл, відредагувати його у вебредакторі GitHub, закомітити в нову гілку, бо main захищена, відкрити pull request, пройти перевірки й рев'ю, змерджити й викласти. А потім зробити git revert змердженої зміни кнопкою Revert на GitHub, розібратися, коли відкочувати, а коли виправляти вперед, і що продакту варто й не варто редагувати самостійно.