Материалы

Статьи, блог, changelog и release notes на сайте.

Материалы

Материалы — поток публикаций сайта: практические заметки о более безопасных сетапах плюс точная запись того, что изменилось. Это не справочник, не каталог и не OpenAPI.

Feature flag — content_hub. Публичный SaaS-профиль его включает. Self-hosted выключает: шапка и подвал опускают Материалы, маршруты дают 404.

URL и кто их видит

Проекция	URL	Кому видно
Human-индекс	`/{locale}/content`	всем, если флаг
Machine-индекс	`/{locale}/ai/content`	всем, если флаг
Human-запись	`/{locale}/content/{type}/{slug}`	всем, если опубликовано
Machine-запись	`/{locale}/ai/content/{type}/{slug}`	всем, если опубликовано

{type} — одно из:

Ключ типа	Подпись в индексе
`article`	Статья
`blog_post`	Практика
`changelog`	История изменений
`release_notes`	Заметки к релизу

Эти четыре ключа — закрытое множество. Пятый тип даёт 404.

Записи локализованы: английские и русские файлы делят type и slug. Опубликованную запись может читать кто угодно. Гейта сессии, лайка и ветки комментариев нет.

Черновики дают 404. Файл с draft: true разбирается в репозитории и никогда не попадает в список, не маршрутизируется, не получает machine-проекцию. Внутренние черновики — не preview URL.

Для чего этот экран

Материалы нужны, чтобы читать продуктовые тексты, которые не являются справочником команд:

как держать границу доверия видимой;
что изменилось в реестре;
заметки к релизу нумерованной линии.

Справочник — для how-to, которые следят за CLI и сайтом. Каталог — для объектов, которые можно установить.

Материалы не:

публикуют компонент;
меняют правовую политику (это Правовые документы);
принимают пользовательские материалы в браузере;
показывают будущие даты published_at (они проваливают снимок).

Что на экране

Индекс

Элемент	Содержимое
Заголовок	Материалы
Описание	Практические заметки о безопасных сетапах coding agents и точная история изменений продукта.
Типы публикаций	четыре подписи типов
Главный материал	новейшая опубликованная запись, крупно
Последние публикации	остальные, сначала новые

Каждая строка показывает тип, published_at (ISO-дата), заголовок, описание. Читать материал открывает /{locale}/content/{type}/{slug}.

Пустой индекс (нет опубликованных записей в этой locale) всё равно рендерит шапку и пустой список последних. Это типизированная пустота, не 404.

Запись

Элемент	Содержимое
Назад	← Материалы
Тип	Статья / Практика / История изменений / Заметки к релизу
Дата	`published_at`
Заголовок	title из frontmatter
Описание	description из frontmatter
Теги	до двенадцати строк
Тело	Markdown; изображения из `/content/illustrations/…`

Переключатель Human / Machine сохраняет type и slug. Machine-индекс перечисляет заголовки и URL. Machine-запись — статья как Markdown.

JSON-LD отдаётся для краулеров. Это не паспорт.

Соответствующие команды CLI

CLI хаба материалов нет. Каталог и справка остаются:

ai-stp registry search --json
ai-stp task intents --json
ai-stp link web --json

link web может напечатать канонический URL сайта, когда цель — поддерживаемый вид. Slug материалов — не stable_id каталога. Не передавайте slug статьи в registry show.

Тупики

Что видно	Что это значит	Что делать
В шапке нет Материалов	`content_hub` выключен	пользуйтесь MkDocs и Каталогом
`/{locale}/content` 404	флаг выключен или опечатка в пути	Карта веба
Запись 404	неизвестный type/slug, другая locale или черновик	откройте индекс; не угадывайте черновики
Пустой список последних	в этой locale ничего не опубликовано	смените locale или подождите
Нет изображения	иллюстрации нет в снимке	статья всё равно читается
Поиск MkDocs находит тему	справочник — другое дерево	это ожидаемо
Нельзя комментировать	комментариев нет	Жалоба на объект или Контакт

Черновики лежат в docs-user-facing/content/ для авторов. Это не публичный preview. Запрос ?draft=1 их не открывает.

Материалы vs документация vs правовое vs каталог

Дерево	URL	Изменяемость	Черновики
Хаб материалов	`/{locale}/content/{type}/{slug}`	опубликованный снимок	404
Справочник	MkDocs и `/{locale}/docs`	Markdown, опубликованный git	флага draft нет
Правовые документы	`/{locale}/legal/{slug}`	неизменяемая редакция политики	n/a
Каталог	`/{locale}/catalog/…`	неизменяемый объект `X.Y`	неопубликованное 404

Типы закрыты. blog_post в UI подписан как Практика; путь всё равно говорит blog_post. Не выдумывайте tutorial или rfc.

Паритет locale: у опубликованной английской записи есть русская пара с тем же type и slug, и наоборот. Переключение en ↔ ru в шапке сохраняет type и slug.

Machine-материалы — тело статьи. Это не паспорт и не OpenAPI.

Связанные страницы

Эта документация — how-to против практических заметок.
Каталог — объекты, не статьи.
Правовые документы — версионированные политики, не changelog.
Главная — продуктовый лендинг, не индекс блога.
Публикация — публикация компонентов.
Доверие и безопасность — темы, к которым статьи часто возвращаются.

!!! note "Четыре типа, один хаб" article, blog_post, changelog и release_notes делят одну выдачу. Это не четыре сайта. Вид skill — компонент, не тип материалов.