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

- **Кому:** `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 обязана
показывать это прямо, иначе читатель решит, что релиз был.