-
Процесс управления релизами для частых выпусков
Процесс управления релизами для софтверных команд в семь шагов, с владельцем и критерием выхода для каждого, плюс метрики DORA и ещё один показатель.
Инженерия6 мин чтения
-
Кто пишет changelog, а кто должен
Кто пишет changelog? Автор PR знает, что изменилось, а PM знает, почему это важно. Ни один из них в одиночку не напишет запись, полезную клиентам.
Инженерия5 мин чтения
-
Форматы файлов changelog: JSON, YAML или просто Markdown
Формат файла changelog решает, может ли он питать страницу и виджет сразу, или его читает только человек. Markdown, JSON и YAML стоят по-разному.
Инженерия5 мин чтения
-
Проверка changelog для GitHub Actions
Проверка changelog в GitHub Actions не пускает merge без записи: шаг, который держится на памяти, обязательно забывают. Как её настроить и что она ломает.
Инженерия5 мин чтения
-
Git-теги, релизы и ваш changelog
Git-тег, релиз и запись changelog — три записи одного события. Их смешивание заставляет changelog дрейфовать. Как трём этим вещам следует совпадать.
Инженерия4 мин чтения
-
Changelog монорепозитория: один, или по одному на пакет?
Монорепозиторий может вести один changelog на весь репозиторий или по одному на пакет. Неверный выбор делает релиз либо слишком шумным, либо разрозненным.
Инженерия4 мин чтения
-
Semantic versioning и ваш changelog
Semantic versioning ещё до чтения changelog говорит, насколько болезненным будет релиз. Что обещает каждая цифра версии и что должна сказать запись.
Инженерия5 мин чтения
-
Как сделать страницу changelog, за которой следят
Страница changelog оправдывает себя, когда люди возвращаются на неё. Где ей место, что нужно каждой записи, потоки и разметка, и куда встроить виджет.
Инженерия5 мин чтения
-
Автоматизация changelog и её пределы
Автоматизируйте сбор, форматирование и публикацию. Не автоматизируйте отбор или формулировку. Где граница и что происходит, когда она сдвигается.
Инженерия5 мин чтения
-
От conventional commits к changelog
Conventional commits делают changelog выводимым из истории, но не делают его читаемым. Что даёт эта конвенция, где она заканчивается и как закрыть разрыв.
Инженерия5 мин чтения
-
Keep a Changelog, реально внедрённый
Спецификация Keep a Changelog занимает одну страницу, но команды сбиваются при внедрении. Что она требует, что оставляет на ваше усмотрение и где подводит.
Инженерия5 мин чтения
