Версии и релизы

Жизненный цикл

1. Черновик — новый список начинается как черновик, видимый только вам. Правки применяются на месте; черновики не создают версий.
2. Публикация — делает неизменяемый снимок: версию N. На странице списка всегда показана текущая версия; старые остаются доступны в разделе Versions.
3. Новые правки — редактирование опубликованного списка идёт в рабочей копии; следующая публикация даёт версию N+1 с заметкой об изменениях.

Заметки об изменениях работают как сообщения коммитов. Можно написать её самому, а можно попросить ИИ сгенерировать её по diff'у между версиями.

Релизы

Версии дешёвые и появляются автоматически; релизы — осознанное решение. Релиз помечает конкретную версию тегом, заголовком и заметками в markdown — ровно как GitHub Releases. Используйте их, чтобы сказать: «вот эта редакция — та самая».

• Тег. Буквы, цифры, ., -, _, до 40 знаков — например 1.2.0 или v1.2.0. Имена вида v3 (буква v и одни цифры) заняты: так git помечает сами версии. Занятый тег не переносится на другую версию — выберите другой.

• Из агента. Релиз можно выпустить через MCP: create_release (в два шага — сначала отчёт, потом confirm: true), а list_releases покажет выпущенные. Тег уходит и в зеркала списка; удаление релиза на сайте тег в git не снимает.

• Автозаметки. Кнопка «Сгенерировать из изменений» соберёт заметки по диффу выбранной версии против предыдущего релиза, с секциями Добавлен / Изменён / Удалён / Перемещён. Текст можно поправить перед публикацией.

• Пред-релиз. Галочка «Пред-релиз» помечает релиз как черновой: он не получает бейдж «Последняя» (им остаётся ближайший обычный релиз) и не влияет на содержимое версии — только на маркировку.

• Ассеты. У каждого релиза можно скачать список в Markdown, HTML и как git bundle (.bundle), посмотреть его версию и сравнить с предыдущей.

• Atom-фид. Публичные списки отдают ленту релизов по адресу /{owner}/{slug}/releases.atom — подпишитесь, чтобы следить за новыми.

Что под капотом: git

За каждым списком стоит настоящий git-репозиторий, где каждая версия — коммит, меняющий list.json. Именно поэтому версии неизменяемы, их можно сравнивать и клонировать — см. Доступ по git.