For LLM agents

Эта страница говорит агенту, как читать портал дёшево и надёжно.

Машинная поверхность (контракт)

Артефакт	Назначение
/developers/llms.txt	Курируемые точки входа с однострочными описаниями плюс секция Instructions
/developers/llms-full.txt	Вся дока одним Markdown-документом
/developers/<path>.md	Markdown-двойник каждой HTML-страницы — бери его, не HTML
/developers/manifest.json	Nav-дерево + карта роут → content-хэш; сравнивай хэши, чтобы найти изменившиеся страницы
/developers/versions.json	Опубликованные версии доков и время текущей сборки
/developers/api/openapi.json	Замороженный контракт OpenAPI, из которого сгенерирован REST-справочник этой сборки
/developers/sitemap.md	Все страницы плоским списком .md-двойников — самый дешёвый полный индекс

Практические правила

1. Предпочитай .md-двойники HTML — тот же контент, доля токенов.
2. Чтобы понять, что изменилось с прошлого чтения, храни карту pages из manifest.json и сравнивай с текущей — хэш роута меняется только тогда, когда меняется содержимое самой страницы.
3. Английские страницы — канон; русские зеркала существуют для людей.
4. Mermaid-диаграммы сохраняют исходник в .md-двойниках — читай код-блок, не тяни отрендеренный SVG.