У нас несколько changelog:
И мы несколько путаемся где насколько подробно писать.
Кроме того, мажорные релизы добавляют еще правила перехода с релиза на релиз (какие файлы конфигов добавить, какие переменные нужны). Их писать в changelog тоже не очень верно, так как раздувает и путает его.
Тут думаю надо в диреткорию doc добавить release_notes или upgrade, и там отдельные страницы перехода с релиза на релиз.