Лента обновлений

Лента обновлений рассказывает, что нового в продукте: по релизам, с разбивкой на «Новое» и «Исправлено». У неё две версии. Внутренняя лента — страница «Релизы» в облаке, для вашей команды: в ней видны открытый, замороженные и выпущенные релизы, ссылки на фичи и блок архитектуры. Публичная лента открывается по ссылке без входа и показывает только названия и фразы «что нового» — без ссылок внутрь, людей и коммитов.

Где в облакеКопировать ссылку на раздел

• Страница «Релизы»: сайдбар, группа «Продукт» → «Релизы» (адрес /app/<пространство>/releases). Видят все участники. Старый адрес /changelog ведёт на неё.
• Настройки публичной ленты: «Настройки» → вкладка «Публичные страницы» → секция «Лента обновлений». Менять могут владелец и админ.
• Публичная страница: <адрес облака>/changelog/<адрес ленты>; для подписки есть лента в формате Atom (RSS), одна запись на релиз.

Откуда берутся записиКопировать ссылку на раздел

Источник записей — выкатки, а группирует их релиз: у каждого выпущенного релиза своя карточка «Релиз 18 · 31 октября · 6 фич, 2 исправления». Выкатка появляется двумя способами.

1. Из журнала. Агент после выкатки вызывает record_release. В параметре notes он даёт на каждый пункт выпуска название для людей и одну фразу «что нового» (до 160 символов), а в items — идентификаторы фич. После синхронизации выпуск оказывается в облаке. Подробнее о выпусках — в разделе Выпуски.
2. Вручную. На странице «Релизы» у открытого или замороженного релиза есть кнопка «Выпустить» (когда включён учёт выпуска; нажать её могут владелец и админ). Перед выпуском Actari просит подтверждение: «Выпустить Релиз 19? Фичи релиза станут выпущенными, уйдёт сообщение о выпуске». Состав релиза становится выпуском, фичи — записями «Новое».

Как пункт превращается в запись:

• пункт — фича с карточкой в облаке: запись «Новое», название берётся из карточки, фраза — из notes, а если её нет, из первого предложения раздела «Цель» описания фичи;
• пункт без карточки, но с notes — запись «Исправлено»;
• пункт без карточки и без notes — берётся название и вторая строка артефакта журнала released: <slug>;
• если не нашлось ничего, запись остаётся «голой»: она есть во внутренней ленте, но в публичную не попадает.

В пределах релиза записи всех выкаток объединяются: сначала «Новое», потом «Исправлено». Даты считаются по московскому времени.

Страница «Релизы»Копировать ссылку на раздел

Сверху текущий открытый релиз («Релиз 19 · готовится», его фичи, отсечка по расписанию, кнопки «Заморозить сейчас» и «Выпустить»), ниже другие открытые и замороженные релизы; у замороженного написано, когда он заморожен, а залежавшийся подсвечен: «Заморожен 3 ноября, выкатки нет 9 дней». В режиме «Вручную» сверху есть кнопка «Новый релиз». Затем выпущенные релизы: у самого свежего пометка «Последний», над лентой переключатель месяцев и фильтр по проектам (если проектов несколько). Если учёт выпуска выключен, видны только выпущенные: выкатки по факту. Релиз открывается отдельной страницей (заголовок или ссылка «Страница релиза» у карточки) — с составом, тест-планом, регрессиями и архитектурой, см. Тест-план. Если запись сделана по принятому публичному запросу, внизу видна ссылка «по запросу пользователей · N голосов». Старые релизы подгружает кнопка «Раньше».

В карточке релиза раскрывается список выкаток: время, проект, ссылка на коммит или тег и количество пунктов. Для владельца и админа здесь же «Скрыть выпуск» и «Вернуть выпуск», а у каждой записи меню с «Скрыть из публичной» и «Вернуть в публичную». Возле записей, которые не попадут наружу, написана причина: «Не в публичной ленте: нет фразы» или «проект не выбран в настройках». Текст записи в облаке не правится, зато любую запись можно скрыть.

У выпуска может быть блок «Архитектура»: изменённые элементы карты системы, добавленные и заменённые решения и расхождения, найденные приёмкой.

Как включить публичную лентуКопировать ссылку на раздел

1. Откройте «Настройки → Публичные страницы → Лента обновлений».
2. Включите «Публичная лента».
3. В «Проекты» отметьте «Все проекты» или конкретные проекты журнала, выпуски которых нужно показывать. Ручные выпуски без проекта попадают только при «Все проекты».
4. В «Адрес» задайте адрес ленты: от 3 до 48 символов, строчная латиница, цифры и дефис. Если оставить пустым, при первом включении подберётся случайный. Рядом появится готовая «Ссылка» с кнопкой «Скопировать».
5. Нажмите «Сохранить».

Адрес общий с публичной страницей запросов: смена адреса ленты меняет и адрес запросов. Название пространства в шапке публичной страницы берётся из «Настройки → Общие».

Публичная страницаКопировать ссылку на раздел

Страница показывает один месяц и выпущенные релизы, переключатель месяцев и ссылки «Подписаться (RSS)» и «Скопировать адрес». Если включены и лента, и запросы, вверху две вкладки: «Обновления» и «Запросы». Страница не индексируется поисковиками, а выключенная лента или неверный адрес дают «не найдено». Открытого и замороженного релиза в публичной ленте нет: только выпущенные. В запись публично попадает только то, что вы не скрыли и что вышло в выбранном проекте; скрытое пропадает сразу.

Уведомления о выпускеКопировать ссылку на раздел

Релиз, выпущенный записью из журнала или кнопкой, приходит и в Telegram сообщением «Релиз N» — в группу или, если групп нет, в личку подключённым участникам. Если лента публична, в конце сообщения есть ссылка на неё. Сообщения отключаются переключателем «Выпуски: что вышло на прод» в «Настройки → Уведомления». Если выпуск сделан по принятому запросу, его автор и подписчики получают письмо «Вышло» с ссылкой на день ленты.

Связь с журналом и агентамиКопировать ссылку на раздел

Лента — это витрина журнала. Чем лучше агент заполняет notes в record_release, тем понятнее запись для пользователя. Параметры record_release описаны в справочнике MCP, а цикл выкатки — в разделе Скиллы цикла.