[newbies] changelog in spec and commit message

[Leonid Krivoshein]

Добрый день!


On 9/25/25 14:33, Alexander Lubyagin wrote:
> В каких случаях запись 'commit message' (git commit -m) дублирует 
> многострочную запись в spec's changelog?
>
> В каких случаях они различаются? Есть ли рекомендации?
>

Это разные сущности, их вообще не стоит связывать и сравнивать.

Commit message делается по каждому изменению в git'е для других 
разработчиков. Заголовок сообщения отвечает на вопрос, что делает 
коммит, а тело сообщения -- на вопрос, зачем он это делает. Для многих 
коммитов, если это и так очевидно, тело сообщения можно опустить. Ширина 
теста в обоих случаях должна быть ограничена, см. в книге 
https://git-scm.com/book/ru/v2 (раздел "Правила создания коммитов").

Changelog в SPEC'ах делается для пользователей, а не для разработчиков. 
В нём не нужно отражать все изменения в исходниках. В нём отражаются 
наиболее важные изменения новой сборки пакета. По его написанию есть 
своё руководство: 
https://www.altlinux.org/Руководство_по_написанию_changelog

Если я, как разработчик, одним коммитом в git/исходники вношу важное 
изменение в будущую сборку, только тогда сообщения в changelog и commit 
message совпадут, такое встречается, но не так часто.


-- 
WBR, Leonid Krivoshein.