Shipped Channel Updates: document llms.txt v2 split indexes

ai/llmstxt.mdx

@@ -30,7 +30,7 @@
 - `X-Llms-Txt`: A convenience header for tools that check for `llms.txt` support.
 
 ```http Response headers
 Link: </llms.txt>; rel="llms-txt", </llms-full.txt>; rel="llms-full-txt", </.well-known/api-catalog>; rel="api-catalog", </.well-known/mcp/server-card.json>; rel="mcp-server-card", </.well-known/agent-card.json>; rel="agent-card", </.well-known/agent-skills/index.json>; rel="agent-skills"
 X-Llms-Txt: /llms.txt
 ```
 
@@ -57,20 +57,26 @@
 
 ## Split indexes under `/_llms`
 
-Automatically generated `llms.txt` index files cannot exceed 100,000 characters. When an index is larger than this limit, Mintlify keeps the main `llms.txt` file as a directory and moves groups of page links into generated Markdown files under `/_llms/`. This limit does not apply to `llms-full.txt`.
+Automatically generated `llms.txt` index files cannot exceed 100,000 characters. When an index is larger than this limit, Mintlify keeps the main `llms.txt` file as a directory and moves groups of page links into generated Markdown files under `/_llms/`. Every page stays discoverable: splitting never omits pages from the index. This limit does not apply to `llms-full.txt`.
 
-For example, a large site might link to the following generated index:
+Links to generated indexes appear in an `Indexes` section. Each link includes the group's breadcrumb, its page count, and a description:
 
 ```mdx
-- [API reference](https://docs.example.com/_llms/api-reference.md)
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
 ```
 
-Agents should follow these index links recursively until they reach documentation page links. The generated files are part of `llms.txt` and do not need to exist in your repository. They are separate from `llms-full.txt`.
+A generated index can link to further indexes. For example, `/_llms/api-reference.md` can link to `/_llms/api-reference/admin.md` when a group is too large for a single file. Agents should follow these index links recursively until they reach documentation page links. Mintlify may shorten page descriptions in a split index to keep each file under the character limit.
+
+The generated files are part of `llms.txt` and do not need to exist in your repository. They are separate from `llms-full.txt`.
 
 The `/_llms/` route uses the same base path as your documentation:
 
 - A root-hosted site serves an index at `https://docs.example.com/_llms/api-reference.md`.
 - A site hosted at `/docs` serves it at `https://example.com/docs/_llms/api-reference.md`.
 
 If you use a reverse proxy or path allowlist, forward the generated route in addition to `llms.txt`. A broad `<base-path>/*` rule already includes `<base-path>/_llms/*`. With granular rules, add `<base-path>/_llms/*` explicitly. See [Reverse proxy](/deploy/reverse-proxy#routing-configuration) for routing guidance.
 

es/ai/llmstxt.mdx

@@ -61,15 +61,21 @@ Este enfoque estructurado permite a los LLM procesar tu documentación de forma
   ## Índices divididos bajo `/_llms`
 </div>
 
-Los archivos de índice `llms.txt` generados automáticamente no pueden superar los 100.000 caracteres. Cuando un índice supera este límite, Mintlify mantiene el archivo `llms.txt` principal como un directorio y traslada grupos de enlaces de páginas a archivos Markdown generados bajo `/_llms/`. Este límite no se aplica a `llms-full.txt`.
+Los archivos de índice `llms.txt` generados automáticamente no pueden superar los 100.000 caracteres. Cuando un índice supera este límite, Mintlify mantiene el archivo `llms.txt` principal como un directorio y traslada grupos de enlaces de páginas a archivos Markdown generados bajo `/_llms/`. Todas las páginas siguen siendo descubribles: la división nunca omite páginas del índice. Este límite no se aplica a `llms-full.txt`.
 
-Por ejemplo, un sitio grande podría enlazar al siguiente índice generado:
+Los enlaces a los índices generados aparecen en una sección `Indexes`. Cada enlace incluye la ruta de navegación del grupo, su número de páginas y una descripción:
 
 ```mdx
-- [API reference](https://docs.example.com/_llms/api-reference.md)
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
 ```
 
-Los agentes deben seguir estos enlaces de índice de forma recursiva hasta llegar a los enlaces de las páginas de documentación. Los archivos generados forman parte de `llms.txt` y no necesitan existir en tu repositorio. Son independientes de `llms-full.txt`.
+Un índice generado puede enlazar a otros índices. Por ejemplo, `/_llms/api-reference.md` puede enlazar a `/_llms/api-reference/admin.md` cuando un grupo es demasiado grande para un solo archivo. Los agentes deben seguir estos enlaces de índice de forma recursiva hasta llegar a los enlaces de las páginas de documentación. Mintlify puede acortar las descripciones de las páginas en un índice dividido para mantener cada archivo por debajo del límite de caracteres.
+
+Los archivos generados forman parte de `llms.txt` y no necesitan existir en tu repositorio. Son independientes de `llms-full.txt`.
 
 La ruta `/_llms/` usa la misma ruta base que tu documentación:
 

fr/ai/llmstxt.mdx

@@ -61,15 +61,21 @@ Cette approche structurée permet aux LLMs de traiter efficacement votre documen
   ## Index scindés sous `/_llms`
 </div>
 
-Les fichiers d'index `llms.txt` générés automatiquement ne peuvent pas dépasser 100 000 caractères. Lorsqu'un index dépasse cette limite, Mintlify conserve le fichier `llms.txt` principal comme répertoire et déplace des groupes de liens de pages vers des fichiers Markdown générés sous `/_llms/`. Cette limite ne s'applique pas à `llms-full.txt`.
+Les fichiers d'index `llms.txt` générés automatiquement ne peuvent pas dépasser 100 000 caractères. Lorsqu'un index dépasse cette limite, Mintlify conserve le fichier `llms.txt` principal comme répertoire et déplace des groupes de liens de pages vers des fichiers Markdown générés sous `/_llms/`. Chaque page reste découvrable : la scission n'omet jamais de pages de l'index. Cette limite ne s'applique pas à `llms-full.txt`.
 
-Par exemple, un site volumineux peut pointer vers l'index généré suivant :
+Les liens vers les index générés apparaissent dans une section `Indexes`. Chaque lien inclut le fil d'Ariane du groupe, son nombre de pages et une description :
 
 ```mdx
-- [API reference](https://docs.example.com/_llms/api-reference.md)
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
 ```
 
-Les agents doivent suivre ces liens d'index de manière récursive jusqu'à atteindre les liens des pages de documentation. Les fichiers générés font partie de `llms.txt` et n'ont pas besoin d'exister dans votre référentiel. Ils sont distincts de `llms-full.txt`.
+Un index généré peut pointer vers d'autres index. Par exemple, `/_llms/api-reference.md` peut pointer vers `/_llms/api-reference/admin.md` lorsqu'un groupe est trop volumineux pour un seul fichier. Les agents doivent suivre ces liens d'index de manière récursive jusqu'à atteindre les liens des pages de documentation. Mintlify peut raccourcir les descriptions de pages dans un index scindé pour maintenir chaque fichier sous la limite de caractères.
+
+Les fichiers générés font partie de `llms.txt` et n'ont pas besoin d'exister dans votre référentiel. Ils sont distincts de `llms-full.txt`.
 
 La route `/_llms/` utilise le même chemin de base que votre documentation :
 

zh/ai/llmstxt.mdx

@@ -61,15 +61,21 @@ X-Llms-Txt: /llms.txt
   ## `/_llms` 下的拆分索引
 </div>
 
-自动生成的 `llms.txt` 索引文件不能超过 100,000 个字符。当索引超过此限制时，Mintlify 会将主 `llms.txt` 文件保留为目录形式，并将成组的页面链接移入位于 `/_llms/` 下的生成 Markdown 文件中。此限制不适用于 `llms-full.txt`。
+自动生成的 `llms.txt` 索引文件不能超过 100,000 个字符。当索引超过此限制时，Mintlify 会将主 `llms.txt` 文件保留为目录形式，并将成组的页面链接移入位于 `/_llms/` 下的生成 Markdown 文件中。所有页面仍然可被发现：拆分绝不会从索引中省略页面。此限制不适用于 `llms-full.txt`。
 
-例如，一个大型站点可能会链接到如下生成的索引：
+指向生成索引的链接会出现在 `Indexes` 部分。每个链接都包含该分组的面包屑路径、页面数量和描述：
 
 ```mdx
-- [API reference](https://docs.example.com/_llms/api-reference.md)
+> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.
+
+## Indexes
+
+- [API reference (250 pages)](https://docs.example.com/_llms/api-reference.md): Endpoint documentation for the example API
 ```
 
-代理应递归跟随这些索引链接，直至到达文档页面链接。这些生成的文件属于 `llms.txt` 的一部分，无需存在于你的仓库中。它们与 `llms-full.txt` 相互独立。
+生成的索引可以链接到更深层的索引。例如，当某个分组过大而无法放入单个文件时，`/_llms/api-reference.md` 可以链接到 `/_llms/api-reference/admin.md`。代理应递归跟随这些索引链接，直至到达文档页面链接。Mintlify 可能会缩短拆分索引中的页面描述，以使每个文件保持在字符限制以内。
+
+这些生成的文件属于 `llms.txt` 的一部分，无需存在于你的仓库中。它们与 `llms-full.txt` 相互独立。
 
 `/_llms/` 路由使用与你的文档相同的基础路径：