From 915dff8c31a9ce3c5e7f6bd587ed94290832376d Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 19 May 2026 05:06:40 +0000 Subject: [PATCH 1/2] docs: clarify llms-full.txt behavior on authenticated sites --- ai/llmstxt.mdx | 6 +++++- deploy/authentication-setup.mdx | 2 +- es/ai/llmstxt.mdx | 6 +++++- es/deploy/authentication-setup.mdx | 2 +- fr/ai/llmstxt.mdx | 6 +++++- fr/deploy/authentication-setup.mdx | 2 +- zh/ai/llmstxt.mdx | 6 +++++- zh/deploy/authentication-setup.mdx | 2 +- 8 files changed, 24 insertions(+), 8 deletions(-) diff --git a/ai/llmstxt.mdx b/ai/llmstxt.mdx index b17e66db43..59ecbda827 100644 --- a/ai/llmstxt.mdx +++ b/ai/llmstxt.mdx @@ -12,7 +12,11 @@ The [llms.txt file](https://llmstxt.org) is an industry standard that helps LLMs Mintlify automatically hosts an `llms.txt` file at the root of your project that lists all available pages in your documentation. This file is always up to date and requires zero maintenance. You can optionally add a custom `llms.txt` file to the root of your project. - If your site requires authentication, `llms.txt` and `llms-full.txt` also require authentication to view. LLMs and AI tools that cannot authenticate into your site cannot access these files. The files exclude pages that belong to [user groups](/deploy/authentication-setup#control-access-with-groups). + Authentication changes how these files are served: + + - **Fully authenticated sites** (every page protected): `llms-full.txt` is not generated and returns a 404. `llms.txt` still lists pages but the linked pages require authentication. + - **Partially authenticated sites** (some public pages): `llms.txt` and `llms-full.txt` include only public pages. Pages behind authentication or assigned to [user groups](/deploy/authentication-setup#control-access-with-groups) are excluded, even for authenticated viewers. + - **Public sites**: Full support. For more information on how authentication affects AI features, see [Feature availability](/deploy/authentication-setup#feature-availability). diff --git a/deploy/authentication-setup.mdx b/deploy/authentication-setup.mdx index fe9b86142a..bba39c3e55 100644 --- a/deploy/authentication-setup.mdx +++ b/deploy/authentication-setup.mdx @@ -464,7 +464,7 @@ Some features behave differently or are unavailable when you enable authenticati | Feature | Public | Fully authenticated (all pages protected) | Partially authenticated (some public pages) | | :------ | :---------- | :---------------------------------- | :-------------------------------- | -| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | Available behind authentication, so AI tools may not be able to access the files | Available behind authentication, so AI tools may not be able to access the files | +| [llms.txt and llms-full.txt](/ai/llmstxt) | Full support | `llms-full.txt` is not available and returns a 404. `llms.txt` is served, but the pages it links to require authentication | Only public pages are included. Pages behind authentication or assigned to user groups are excluded, even for authenticated viewers | | [MCP server](/ai/model-context-protocol) | Full support | Requires authentication to connect | Available without authentication for public pages and with authentication for protected pages | | [Markdown export](/ai/markdown-export) | Full support | Full support, respects user groups | Full support, respects user groups | | [PDF export](/optimize/pdf-exports) | Full support | Not supported | Not supported | diff --git a/es/ai/llmstxt.mdx b/es/ai/llmstxt.mdx index 3651bb2c4b..38089bf7bb 100644 --- a/es/ai/llmstxt.mdx +++ b/es/ai/llmstxt.mdx @@ -12,7 +12,11 @@ El [archivo llms.txt](https://llmstxt.org) es un estándar del sector que ayuda Mintlify aloja automáticamente un archivo `llms.txt` en la raíz de tu proyecto que lista todas las páginas disponibles de tu documentación. Este archivo siempre está actualizado y no requiere mantenimiento. Opcionalmente, puedes añadir un `llms.txt` personalizado en la raíz de tu proyecto. - Si tu sitio requiere autenticación, `llms.txt` y `llms-full.txt` también requieren autenticación para poder verse. Los LLM y las herramientas de IA que no puedan autenticarse en tu sitio no pueden acceder a estos archivos. Los archivos excluyen las páginas que pertenecen a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups). + La autenticación cambia cómo se sirven estos archivos: + + - **Sitios totalmente autenticados** (todas las páginas protegidas): `llms-full.txt` no se genera y devuelve un 404. `llms.txt` sigue listando las páginas, pero las páginas enlazadas requieren autenticación. + - **Sitios parcialmente autenticados** (algunas páginas públicas): `llms.txt` y `llms-full.txt` solo incluyen páginas públicas. Las páginas detrás de autenticación o asignadas a [grupos de usuarios](/es/deploy/authentication-setup#control-access-with-groups) se excluyen, incluso para visitantes autenticados. + - **Sitios públicos**: Compatibilidad completa. Para obtener más información sobre cómo la autenticación afecta las funciones de IA, consulta [Disponibilidad de funciones](/es/deploy/authentication-setup#feature-availability). diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx index 8a7799fef1..142f5b67aa 100644 --- a/es/deploy/authentication-setup.mdx +++ b/es/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ Algunas funciones se comportan de manera diferente o no están disponibles cuand | Función | Público | Totalmente autenticado (todas las páginas protegidas) | Parcialmente autenticado (algunas páginas públicas) | | :----------------------------------------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------- | -| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | Disponible tras autenticación, por lo que es posible que las herramientas de IA no puedan acceder a los archivos | +| [llms.txt and llms-full.txt](/es/ai/llmstxt) | Compatibilidad completa | `llms-full.txt` no está disponible y devuelve un 404. `llms.txt` se sirve, pero las páginas enlazadas requieren autenticación | Solo se incluyen las páginas públicas. Las páginas detrás de autenticación o asignadas a grupos de usuarios se excluyen, incluso para visitantes autenticados | | [Servidor MCP](/es/ai/model-context-protocol) | Compatibilidad completa | Requiere autenticación para conectarse | Disponible sin autenticación para páginas públicas y con autenticación para páginas protegidas | | [Exportación a Markdown](/es/ai/markdown-export) | Compatibilidad completa | Compatibilidad completa, respeta los grupos de usuarios | Compatibilidad completa, respeta los grupos de usuarios | | [Exportación a PDF](/es/optimize/pdf-exports) | Compatibilidad completa | No compatible | No compatible | diff --git a/fr/ai/llmstxt.mdx b/fr/ai/llmstxt.mdx index 966b22071a..6fd2a4486d 100644 --- a/fr/ai/llmstxt.mdx +++ b/fr/ai/llmstxt.mdx @@ -12,7 +12,11 @@ Le [fichier llms.txt](https://llmstxt.org) est une norme du secteur qui aide les Mintlify héberge automatiquement, à la racine de votre projet, un fichier `llms.txt` qui répertorie toutes les pages disponibles de votre documentation. Ce fichier est toujours à jour et ne nécessite aucun entretien. Vous pouvez également ajouter un fichier `llms.txt` personnalisé à la racine de votre projet. - Si votre site nécessite une authentification, `llms.txt` et `llms-full.txt` sont également soumis à une authentification pour être consultés. Les LLM et les outils d'IA qui ne peuvent pas s'authentifier sur votre site ne peuvent pas accéder à ces fichiers. Les fichiers excluent les pages qui appartiennent à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups). + L'authentification change la manière dont ces fichiers sont servis : + + - **Sites entièrement authentifiés** (toutes les pages protégées) : `llms-full.txt` n'est pas généré et renvoie une 404. `llms.txt` continue de lister les pages, mais les pages liées nécessitent une authentification. + - **Sites partiellement authentifiés** (certaines pages publiques) : `llms.txt` et `llms-full.txt` n'incluent que les pages publiques. Les pages protégées par authentification ou assignées à des [groupes d'utilisateurs](/fr/deploy/authentication-setup#control-access-with-groups) sont exclues, même pour les visiteurs authentifiés. + - **Sites publics** : Prise en charge complète. Pour plus d'informations sur l'impact de l'authentification sur les fonctionnalités d'IA, voir [Disponibilité des fonctionnalités](/fr/deploy/authentication-setup#feature-availability). diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx index ed46445ae2..e298bd54e2 100644 --- a/fr/deploy/authentication-setup.mdx +++ b/fr/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ Certaines fonctionnalités se comportent différemment ou ne sont pas disponible | Fonctionnalité | Public | Entièrement authentifié (toutes les pages protégées) | Partiellement authentifié (certaines pages publiques) | | :------------------------------------------------------- | :----------------------- | :--------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------- | -| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | Disponible derrière l’authentification, les outils d’IA peuvent donc ne pas avoir accès aux fichiers | +| [llms.txt and llms-full.txt](/fr/ai/llmstxt) | Prise en charge complète | `llms-full.txt` n’est pas disponible et renvoie une 404. `llms.txt` est servi, mais les pages liées nécessitent une authentification | Seules les pages publiques sont incluses. Les pages protégées par authentification ou assignées à des groupes d’utilisateurs sont exclues, même pour les visiteurs authentifiés | | [MCP server](/fr/ai/model-context-protocol) | Prise en charge complète | Nécessite une authentification pour se connecter | Disponible sans authentification pour les pages publiques et avec authentification pour les pages protégées | | [Markdown export](/fr/ai/markdown-export) | Prise en charge complète | Prise en charge complète, respecte les groupes d’utilisateurs | Prise en charge complète, respecte les groupes d’utilisateurs | | [Export PDF](/fr/optimize/pdf-exports) | Prise en charge complète | Non pris en charge | Non pris en charge | diff --git a/zh/ai/llmstxt.mdx b/zh/ai/llmstxt.mdx index 0c249058d4..bb18ea1426 100644 --- a/zh/ai/llmstxt.mdx +++ b/zh/ai/llmstxt.mdx @@ -12,7 +12,11 @@ import { PreviewButton } from "/snippets/previewbutton.jsx" Mintlify 会在项目根目录自动托管一个 `llms.txt` 文件，列出文档中的所有可用页面。该文件始终保持最新且无需维护。你也可以在项目根目录添加自定义的 `llms.txt` 文件。 - 如果你的站点需要认证，查看 `llms.txt` 和 `llms-full.txt` 也同样需要认证。无法通过你站点认证的 LLM 和 AI 工具将无法访问这些文件。这些文件会排除属于[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面。 + 认证会改变这些文件的提供方式： + + - **完全需要认证的站点**（所有页面均受保护）：不会生成 `llms-full.txt`，访问时返回 404。`llms.txt` 仍会列出页面，但其链接的页面需要认证才能访问。 + - **部分需要认证的站点**（部分页面公开）：`llms.txt` 和 `llms-full.txt` 仅包含公开页面。需要认证的页面或分配给[用户分组](/zh/deploy/authentication-setup#control-access-with-groups)的页面会被排除，即使对已认证的访问者也是如此。 + - **公开站点**：完全支持。 有关认证如何影响 AI 功能的更多信息，请参阅[功能可用性](/zh/deploy/authentication-setup#feature-availability)。 diff --git a/zh/deploy/authentication-setup.mdx b/zh/deploy/authentication-setup.mdx index cc871cfcf7..fe71195160 100644 --- a/zh/deploy/authentication-setup.mdx +++ b/zh/deploy/authentication-setup.mdx @@ -496,7 +496,7 @@ groups: ["admin"] | 功能 | 公开 | 完全认证 (所有页面受保护) | 部分认证 (部分页面公开) | | :------------------------------------------------------- | :--- | :----------------------------- | :----------------------------- | -| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | 需要通过认证后才能访问，因此 AI 工具可能无法访问这些文件 | +| [llms.txt 和 llms-full.txt](/zh/ai/llmstxt) | 完全支持 | `llms-full.txt` 不可用，访问时返回 404。`llms.txt` 可访问，但其链接的页面需要认证 | 仅包含公开页面。需要认证的页面或分配给用户分组的页面会被排除，即使对已认证的访问者也是如此 | | [MCP 服务器](/zh/ai/model-context-protocol) | 完全支持 | 连接时需要认证 | 公开页面无需认证即可使用，受保护页面则需要认证 | | [Markdown 导出](/zh/ai/markdown-export) | 完全支持 | 完全支持，尊重用户分组 | 完全支持，尊重用户分组 | | [PDF 导出](/zh/optimize/pdf-exports) | 完全支持 | 不支持 | 不支持 | From 50d747401890039e8b9d00f0d7bf5f6b28f96f41 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Tue, 19 May 2026 05:09:00 +0000 Subject: [PATCH 2/2] docs: expand auth setup descriptions for SEO in es/fr --- es/deploy/authentication-setup.mdx | 2 +- fr/deploy/authentication-setup.mdx | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/es/deploy/authentication-setup.mdx b/es/deploy/authentication-setup.mdx index 142f5b67aa..cab10f1c9e 100644 --- a/es/deploy/authentication-setup.mdx +++ b/es/deploy/authentication-setup.mdx @@ -1,6 +1,6 @@ --- title: "Configuración de autenticación" -description: "Controla el acceso a tu documentación mediante la autenticación de usuarios." +description: "Configura la autenticación de usuarios en tu sitio de documentación con OAuth, JWT o enlaces compartidos para controlar el acceso a las páginas." keywords: ['authentication', 'auth', 'OAuth', 'JWT', 'password'] --- diff --git a/fr/deploy/authentication-setup.mdx b/fr/deploy/authentication-setup.mdx index e298bd54e2..7af6e5d6f0 100644 --- a/fr/deploy/authentication-setup.mdx +++ b/fr/deploy/authentication-setup.mdx @@ -1,6 +1,6 @@ --- title: "Configuration de l'authentification" -description: "Contrôlez l’accès à votre documentation en authentifiant les utilisateurs." +description: "Configurez l'authentification des utilisateurs pour votre site de documentation avec OAuth, JWT ou des liens partagés afin de contrôler l'accès aux pages." keywords: ['authentication', 'auth', 'OAuth', 'JWT', 'password'] ---