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>
87 lines
5.4 KiB
Markdown
87 lines
5.4 KiB
Markdown
# Отчёт: документация приведена в соответствие с историей релизов
|
||
|
||
- **Задание:** `../inbox/2026-08-20-docs-sync.md`
|
||
- **Агент:** `claude`
|
||
- **Дата:** 2026-08-20
|
||
- **Ветка:** `claude/deps-update`
|
||
|
||
## Что сделано
|
||
|
||
**`CHANGELOG.md`.** Дописаны 14 отсутствовавших версий, alpha.7 … alpha.20.
|
||
Записи выведены из тегов и коммитов между ними, а не из памяти. Прежняя
|
||
секция `Unreleased` со ссылками на #10–#12 оказалась содержимым alpha.7 —
|
||
перенесена туда. Новый `Unreleased` описывает слитое после alpha.20: #63,
|
||
#64, #44, #46. Ссылки сравнения версий перестроены для всех 20 тегов.
|
||
|
||
Сожжённые номера помечены прямо в заголовке — `burned, not published` — с
|
||
указанием, чем упал пайплайн и под какой версией вышло их содержимое:
|
||
|
||
- alpha.10 и alpha.11 — пайплайн упал до публикации;
|
||
- alpha.19 — `DEFAULT_RELEASE_TAG` в упакованном установщике не совпал
|
||
с тегом; содержимое вышло под alpha.20.
|
||
|
||
Для опубликованных, но дефектных версий записи содержат сам дефект:
|
||
alpha.8 (осиротевшая подпись без manifest v2), alpha.12 и alpha.13
|
||
(подпись без сертификата Fulcio), alpha.14 (проверяемая, но не
|
||
устанавливаемая на чистый хост), alpha.15 … alpha.17 (на чём остановилась
|
||
проверка). Иначе CHANGELOG подсказывал бы ставить версию, которая не
|
||
ставится.
|
||
|
||
**`docs/release-policy.md`.** Добавлена запись про alpha.20 — что он
|
||
исправляет, что переносит из сожжённого alpha.19.
|
||
|
||
**`docs/roadmap.md`.** Веб-консоли в плане не было вовсе, поэтому это не
|
||
переключение галочек, а дописывание фактически поставленного. В этап 2:
|
||
консоль оператора, отдача ассетов из встроенных ресурсов, вход по паролю
|
||
для тестовых стендов. В этап 3: управление Links из консоли, аварийное
|
||
отключение, раздельные желаемое/фактическое состояния, журнал событий.
|
||
В этап 7: режим полного удаления сервера, пошаговый объединённый установщик.
|
||
|
||
## Как проверено
|
||
|
||
Все 20 версий на месте:
|
||
|
||
```
|
||
$ grep -c "^## \[v0.1.0-alpha" CHANGELOG.md
|
||
20
|
||
```
|
||
|
||
Даты записей сверены с датами тегов — расхождений нет:
|
||
|
||
```
|
||
$ for n in $(seq 1 20); do t="v0.1.0-alpha.$n"; ... done
|
||
v0.1.0-alpha.1 2026-07-16 2026-07-16 совпадает
|
||
...
|
||
v0.1.0-alpha.20 2026-08-18 2026-08-18 совпадает
|
||
```
|
||
|
||
Двадцать строк, все «совпадает».
|
||
|
||
## Что не сделано
|
||
|
||
**README и одиннадцать переводов не тронуты намеренно.** `README.md:101`
|
||
по-прежнему называет `v0.1.0-alpha.14`. `docs/release-policy.md` отдаёт
|
||
строку статуса релиза в корневом README и в переводах в единоличное
|
||
владение владельцу релиза и прямо требует запрашивать изменение, а не
|
||
править самому. Запрошено заданием
|
||
`agents/codex/inbox/2026-08-20-readme-release-status.md`.
|
||
|
||
Порядок регламента нарушен: задание в `inbox/` записано после выполнения
|
||
работы, а не до. Указываю прямо, чтобы это не выглядело соблюдённым.
|
||
|
||
## Замечено рядом
|
||
|
||
1. **`README.md:101` и переводы** — предмет выданного задания Codex.
|
||
2. **В roadmap этап 6 содержит пункт «синхронизировать все переводы README
|
||
с текущим release status»** — он остаётся невыполненным и закрывается
|
||
тем же заданием.
|
||
3. **Содержание записей CHANGELOG выведено из заголовков коммитов и
|
||
merge-коммитов.** Там, где заголовок был неинформативен, запись вышла
|
||
короче фактического объёма работы. Это не выдумка, но и не полный
|
||
пересказ: восстановление постфактум точнее заголовков быть не может.
|
||
|
||
## Вопросы к приёмке
|
||
|
||
Записи alpha.10, alpha.11 и alpha.19 оставлены в CHANGELOG как сожжённые.
|
||
Альтернатива — не упоминать их вовсе. Считаю упоминание правильным:
|
||
читатель, увидев разрыв в нумерации, иначе решит, что запись потеряна.
|