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