devel@ where you _can_ ask
 help / color / mirror / Atom feed
From: Leonid Krivoshein <klark.devel@gmail.com>
To: devel-newbies@lists.altlinux.org
Subject: Re: [newbies] changelog in spec and commit message
Date: Fri, 26 Sep 2025 00:24:28 +0300
Message-ID: <9f475d35-825d-4278-a701-3f4e3ac50efc@gmail.com> (raw)
In-Reply-To: <331cd651-d1dc-44d8-8e80-e6d41b398405@yandex.ru>

Добрый день!


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.



      parent reply	other threads:[~2025-09-25 21:24 UTC|newest]

Thread overview: 5+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2025-09-25 11:33 Alexander Lubyagin
2025-09-25 11:43 ` Anton Farygin
2025-09-25 11:44   ` Anton Farygin
2025-09-25 12:12 ` Paul Wolneykien
2025-09-25 21:24 ` Leonid Krivoshein [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:
  https://en.wikipedia.org/wiki/Posting_style#Interleaved_style

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=9f475d35-825d-4278-a701-3f4e3ac50efc@gmail.com \
    --to=klark.devel@gmail.com \
    --cc=devel-newbies@lists.altlinux.org \
    /path/to/YOUR_REPLY

  https://kernel.org/pub/software/scm/git/docs/git-send-email.html

* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link

devel@ where you _can_ ask

This inbox may be cloned and mirrored by anyone:

	git clone --mirror http://lore.altlinux.org/devel-newbies/0 devel-newbies/git/0.git

	# If you have public-inbox 1.1+ installed, you may
	# initialize and index your mirror using the following commands:
	public-inbox-init -V2 devel-newbies devel-newbies/ http://lore.altlinux.org/devel-newbies \
		devel-newbies@lists.altlinux.org devel-newbies@lists.altlinux.ru devel-newbies@lists.altlinux.com
	public-inbox-index devel-newbies

Example config snippet for mirrors.
Newsgroup available over NNTP:
	nntp://lore.altlinux.org/org.altlinux.lists.devel-newbies


AGPL code for this site: git clone https://public-inbox.org/public-inbox.git