Мне любопытно, какой контент должен быть в комментируемом файле комментария. Должно ли оно описывать в целом то, что изменилось (например, «Экран виджетов был изменен для отображения только активных виджетов»), или оно должно быть более конкретным (например, «В условие where добавлено предложение where запроса fetchWidget для получения по умолчанию только активных виджетов») «)
Насколько атомным должен быть один коммит? Просто файл, содержащий обновленный запрос в одном коммите (например, «Обновлен экран виджетов, чтобы отображать только активные виджеты по умолчанию»), или если это и некоторые другие изменения + изменения интерфейса на экране делят тот же коммит с более общим описанием как («Обновлен экран виджетов: A) отображать только активные виджеты по умолчанию B) Добавлена кнопка для отображения неактивных виджетов»)
Я вижу, что комментарии коммитов подрывной деятельности используются совсем по-другому, и мне было интересно, с чем другие добились успеха. Некоторые комментарии так же кратки, как «обновленные файлы», в то время как другие имеют много абзацев, а другие отформатированы таким образом, что их можно запрашивать и связывать с какой-либо внешней системой, такой как JIRA.
Раньше я очень описывал причину изменений, а также конкретные технические изменения. В последнее время я уменьшал количество и просто давал общий комментарий «Это то, что я изменил на этой странице».