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

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

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

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

Релизы

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

• Автозаметки. Кнопка «Сгенерировать из изменений» соберёт заметки по диффу выбранной версии против предыдущего релиза, с секциями Добавлен / Изменён / Удалён / Перемещён. Текст можно поправить перед публикацией.
• Пред-релиз. Галочка «Пред-релиз» помечает релиз как черновой: он не получает бейдж «Последняя» (им остаётся ближайший обычный релиз) и не влияет на содержимое версии — только на маркировку.
• Ассеты. У каждого релиза можно скачать список в Markdown, HTML и как git bundle (.bundle), посмотреть его версию и сравнить с предыдущей.
• Atom-фид. Публичные списки отдают ленту релизов по адресу /{owner}/{slug}/releases.atom — подпишитесь, чтобы следить за новыми.

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

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