1e6348ff2b
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>
41 lines
2.5 KiB
Markdown
41 lines
2.5 KiB
Markdown
# Привести документацию в соответствие с фактическим состоянием релизов
|
||
|
||
- **Кому:** `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 обязана
|
||
показывать это прямо, иначе читатель решит, что релиз был.
|