Ochenstarik 1e6348ff2b docs: восстановить историю релизов в CHANGELOG, policy и roadmap

CHANGELOG обрывался на alpha.6 от 2026-07-31 при тегах до alpha.20.
Дописаны 14 версий по тегам и коммитам между ними; даты сверены с датами
тегов, расхождений нет. Сожжённые alpha.10, alpha.11 и alpha.19 помечены
как несопубликованные с указанием, чем упал пайплайн. Для опубликованных,
но дефектных версий записан сам дефект, иначе CHANGELOG подсказывал бы
ставить версию, которая не ставится.

В release-policy добавлена запись про alpha.20. В roadmap дописано
фактически поставленное: веб-консоль и её разделы, режим полного удаления
сервера, объединённый установщик.

README и переводы намеренно не тронуты: по release-policy строка статуса
релиза принадлежит владельцу релиза, изменение запрошено заданием Codex.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

2026-08-20 16:36:40 +07:00

2.5 KiB

Raw Blame History

Привести документацию в соответствие с фактическим состоянием релизов

Кому: claude
Дата: 2026-08-20
От кого: владелец проекта (в чате: «делай что можно. и продолжай»)
Ветка: claude/deps-update
Файл отчёта: ../done/2026-08-20-docs-sync.md

Что нужно сделать

CHANGELOG.md заканчивался на v0.1.0-alpha.6 от 2026-07-31, тогда как теги идут до v0.1.0-alpha.20. Секция Unreleased ссылалась на давно слитые #10–#12. docs/release-policy.md вёл построчную историю версий, но обрывался на alpha.19. docs/roadmap.md не отражал подсистемы, слитые в main.

Восстановить историю по фактам репозитория — тегам и коммитам между ними, а не по памяти:

CHANGELOG: записи для alpha.7 … alpha.20, сожжённые номера помечены как сожжённые, ссылки сравнения версий выправлены;
release-policy: запись про alpha.20;
roadmap: отметить фактически поставленное.

Границы

Не менять код, workflow и версии сборки. Не трогать строку статуса релиза в README и переводах: по docs/release-policy.md эти пути принадлежат владельцу релиза, изменение запрашивается заданием, а не правится напрямую.

Как проверить результат

в CHANGELOG присутствуют все 20 версий: grep -c "^## \[v0.1.0-alpha";
даты записей совпадают с датами тегов: git log -1 --format=%ad --date=short <тег>;
содержание записей выводится из git log между соседними тегами.

Контекст и ограничения

Сожжённые номера alpha.10, alpha.11, alpha.19 не переиспользуются: теги существуют, релизы не опубликованы. Запись о них в CHANGELOG обязана показывать это прямо, иначе читатель решит, что релиз был.

2.5 KiB Raw Blame History Unescape Escape