changelog-discipline

CHANGELOG фиксирует каждое законченное изменение кода, но не пересказывает каждый файл и коммит. Механическая правка получает короткую запись; решение — контекст, которого нет в коде: почему сделали именно так, что было до этого и что отвергли.

Scope

• Применять после каждого законченного изменения кода в проекте, где ведётся changelog.
• Применять при настройке changelog в новом проекте.
• Применять при подготовке релиза.
• Не применять для сообщений коммитов, описаний PR и релиз-нот для пользователей — другие форматы, другие читатели.

Core Principles