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.
- Рев'ю очима PM: коментарі, пропозиції, approve · Що продакт перевіряє в pull request, а що лишає інженерам, як коментувати рядок, пропонувати точне формулювання, обирати між Comment, Approve і Request changes і писати коментарі, які приємно отримувати.
- Репозиторій і коміти: як читати сторінку репозиторію · Сторінка репозиторію на GitHub згори донизу, що розповідає сторінка окремого коміту і яким має бути добре повідомлення коміту.
- Анатомія pull request: вкладки, опис, перевірки · Читаємо сторінку pull request згори донизу: базова гілка й гілка змін, чернетка і готовий PR, чотири вкладки, опис, рев'юери й мітки, пов'язані issues, перевірки й блок мерджу.
- Перша зміна в браузері і як її скасувати · Невелика зміна повністю у вебінтерфейсі GitHub: знайти файл, відредагувати, закомітити в нову гілку, бо main захищена, відкрити pull request, пройти перевірки й рев'ю, змерджити й викласти. А потім скасувати змерджену зміну кнопкою Revert, розібратися, коли робити revert, а коли виправляти вперед, і що продакту варто й не варто редагувати самостійно.