AI Ready Docs¶
Polkadot provides files to make documentation content available in a structure optimized for use with large language models (LLMs) and AI tools. These resources help build AI assistants, power code search, or enable custom tooling trained on Polkadot’s documentation.
How to Use These Files¶
- Quick navigation: Use
llms.txtto give models a high-level map of the site. - Lightweight context: Use
site-index.jsonfor smaller context windows or when you only need targeted retrieval. - Full content: Use
llms-full.jsonlfor large-context models or preparing data for RAG pipelines. - Focused bundles: Use category files (e.g.,
basics.md,parachains.md) to limit content to a specific theme or task for more focused responses.
These AI-ready files do not include any persona or system prompts. They are purely informational and can be used without conflicting with your existing agent or tool prompting.
Download LLM Files¶
| Category | Description | File | Actions |
|---|---|---|---|
| Index | Markdown URL index for documentation pages, links to essential repos, and additional resources in the llms.txt standard format. | llms.txt | |
| Site index (JSON) | Lightweight site index of JSON objects (one per page) with metadata and content previews. | site-index.json | |
| Full site contents (JSONL) | Full content of documentation site enhanced with metadata. | llms-full.jsonl | |
| Basics | Polkadot general knowledge base to provide context around overview and beginner-level content. | basics.md | |
| Reference | Reference material including key functions and glossary. | reference.md | |
| Smart Contracts | How to develop and deploy Solidity smart contracts on Polkadot Hub. | smart-contracts.md | |
| Parachains | How-to guides related to building, customizing, deploying, and maintaining a parachain. | parachains.md | |
| DApps | Information and tutorials for application developers. | dapps.md | |
| Networks | Information about the various Polkadot networks (Polkadot, Kusama, Westend, Paseo), their purposes, and how they fit into the development workflow. | networks.md | |
| Polkadot Protocol | Polkadot's core architecture, including the relay chain, parachains, system chains, interoperability, and main actors. | polkadot-protocol.md | |
| Infrastructure | Operational aspects of supporting the Polkadot network, including how to run a node or validator and staking mechanics. | infrastructure.md | |
| Tooling | An overview of various development tools available for Polkadot development. | tooling.md |
Note
The llms-full.jsonl file may exceed the input limits of some language models due to its size. If you encounter limitations, consider using the smaller site-index.json or category bundle files instead.
Last update: October 22, 2025
| Created: August 15, 2025
| Created: August 15, 2025