For LLM agents
This page tells an agent how to read this portal cheaply and reliably.
Machine surface (contract)
Section titled “Machine surface (contract)”| Artifact | Purpose |
|---|---|
/developers/llms.txt | Curated entry points with one-line descriptions, plus an Instructions section |
/developers/llms-full.txt | Entire docs as one Markdown document |
/developers/<path>.md | Markdown twin of every HTML page — fetch this, not the HTML |
/developers/manifest.json | Nav tree + route → content-hash map; compare hashes to detect changed pages |
/developers/versions.json | Published doc versions and the current build timestamp |
/developers/api/openapi.json | The frozen OpenAPI contract this build’s REST reference was generated from |
/developers/sitemap.md | Every page as a flat list of .md twins — the cheapest full index |
Rules of thumb
Section titled “Rules of thumb”- Prefer
.mdtwins over HTML — same content, a fraction of the tokens. - To find what changed since your last read, keep the
pageshash map frommanifest.jsonand compare it to the current one — the per-route hash changes only when that page’s content does. - English pages are canonical; Russian mirrors exist for humans.
- Mermaid diagrams keep their source in the
.mdtwins — read the code block, do not fetch the rendered SVG.