Журнал, записывающий короткий хеш коммита, догнать правкой коммита нельзя

CHANGELOG.md и docs/site/changelog.md печатаются из истории и кладут рядом с каждой записью короткий хеш (db9a25f). Значит запись про коммит появляется только ПОСЛЕ того, как коммит существует, — а хеш коммита зависит от его содержимого, то есть и от файла журнала. Замкнутый круг: перепечатать журнал и вложить его в тот же коммит через git commit --amend нельзя, потому что amend меняет хеш, а с ним и то, что журнал обязан был записать.

Чем подтверждено. На ветке work/versii-doki журнал перепечатан и закоммичен; node scripts/build-changelog.mjs --check после этого показал расхождение ровно в одну запись — про сам коммит перепечатки. Повторный --amend дал бы то же самое с другим хешем.

Как с этим живут. Двумя способами, и оба законны:

• перепечатать журнал ОТДЕЛЬНЫМ коммитом следом («Журнал изменений перепечатан после …»). Отставание тогда ровно одно — на этот коммит, — и следующая перепечатка его подберёт;
• печатать журнал в сборке публикации, а не в дереве. Так сделано у сайта: .github/workflows/pages.yml перепечатывает страницы журналов до сборки и ничего не коммитит, поэтому опубликованное всегда свежее, даже когда дерево отстаёт на один коммит.

Чем ограничено. Речь только про журналы, у которых единица записи — коммит. Страница, печатаемая из ТЕГОВ (docs/site/releases.ru.md), этой беды не имеет: тег ставится на уже существующий коммит, и от содержимого страницы не зависит.

Связано: a-hand-written-list-outlives-the-tree, typed-numbers-drift-substituted-ones-cannot, a-red-inherited-from-the-trunk-must-be-measured-on-the-trunk