diff --git a/assistant/widget.mdx b/assistant/widget.mdx
index 81bdc63f1..6b66158b6 100644
--- a/assistant/widget.mdx
+++ b/assistant/widget.mdx
@@ -132,6 +132,19 @@ Changing `identity` starts a new conversation. Changing the widget ID or API end
You can supply `supportEmail` and `starterQuestions` during initialization and change them later with `update()`. These values apply to the current embed and do not inherit from your Mintlify dashboard.
+## Authenticate end users
+
+Pass a signed `identity` token to `init()` or `update()` to associate a widget session with a specific end user. Omit `identity` for anonymous visitors.
+
+Identity tokens are only verified when your deployment has [JWT authentication](/deploy/authentication-setup) configured. Sign each token on your server with the same private key you registered on the [Authentication](https://app.mintlify.com/settings/deployment/authentication) page in your dashboard, and include the following claims:
+
+- `sub`: A stable identifier for the end user.
+- `aud`: The widget ID.
+- `iat`: The token issue time.
+- `exp`: The token expiration time. Keep the lifetime short and refresh tokens from your backend before they expire.
+
+Sign tokens with `EdDSA` or `ES256`. Never expose your private key or generate tokens in the browser.
+
## Configuration reference
### `AssistantConfig`
diff --git a/deploy/reverse-proxy.mdx b/deploy/reverse-proxy.mdx
index 4e0dc7239..03e6bb361 100644
--- a/deploy/reverse-proxy.mdx
+++ b/deploy/reverse-proxy.mdx
@@ -1,6 +1,6 @@
---
title: "Reverse proxy"
-description: "Configure a custom reverse proxy with Nginx, Apache, or Caddy to serve your Mintlify documentation at a subpath on your own domain."
+description: "Configure a custom reverse proxy with Nginx routing rules, caching, and header forwarding to serve Mintlify docs at a subpath on your own domain."
keywords: ["reverse proxy configuration","nginx","proxy routing","header forwarding"]
---
@@ -8,6 +8,8 @@ import SubpathSetupSteps from "/snippets/subpath-setup-steps.mdx";
To serve your documentation through a custom reverse proxy, you must configure routing rules, caching policies, and header forwarding.
+The routing paths, HTTP methods, and header requirements on this page apply to any reverse proxy. The example configurations use Nginx. Adapt them to another proxy such as Apache, Caddy, or HAProxy by translating each directive to the equivalent syntax.
+
When you implement a reverse proxy, monitor for potential issues with domain verification, SSL certificate provisioning, authentication flows, performance, and analytics tracking.
## Set your base path
diff --git a/es/assistant/widget.mdx b/es/assistant/widget.mdx
index fb090eaa3..52bd60ac2 100644
--- a/es/assistant/widget.mdx
+++ b/es/assistant/widget.mdx
@@ -144,6 +144,21 @@ Cambiar `identity` inicia una nueva conversación. Cambiar el ID del widget o el
Puedes proporcionar `supportEmail` y `starterQuestions` durante la inicialización y cambiarlos más tarde con `update()`. Estos valores se aplican al embed actual y no se heredan desde tu panel de Mintlify.
+
+ ## Autenticar a los usuarios finales
+
+
+Pasa un token de `identity` firmado a `init()` o `update()` para asociar una sesión del widget con un usuario final específico. Omite `identity` para visitantes anónimos.
+
+Los tokens de identidad solo se verifican cuando tu despliegue tiene configurada la [autenticación JWT](/es/deploy/authentication-setup). Firma cada token en tu servidor con la misma clave privada que registraste en la página [Authentication](https://app.mintlify.com/settings/deployment/authentication) de tu panel e incluye las siguientes claims:
+
+- `sub`: Un identificador estable para el usuario final.
+- `aud`: El ID del widget.
+- `iat`: La hora de emisión del token.
+- `exp`: La hora de expiración del token. Mantén una vida útil corta y refresca los tokens desde tu backend antes de que expiren.
+
+Firma los tokens con `EdDSA` o `ES256`. Nunca expongas tu clave privada ni generes tokens en el navegador.
+
## Referencia de configuración
diff --git a/es/deploy/reverse-proxy.mdx b/es/deploy/reverse-proxy.mdx
index c9503c866..3de40065d 100644
--- a/es/deploy/reverse-proxy.mdx
+++ b/es/deploy/reverse-proxy.mdx
@@ -1,6 +1,6 @@
---
title: "Proxy inverso"
-description: "Configura un proxy inverso personalizado con Nginx, Apache o Caddy para servir tu documentación de Mintlify en una subruta de tu propio dominio."
+description: "Configura un proxy inverso personalizado con reglas de enrutamiento de Nginx, caché y reenvío de encabezados para servir la documentación de Mintlify en una subruta de tu propio dominio."
keywords: ["reverse proxy configuration","nginx","proxy routing","header forwarding"]
---
@@ -8,6 +8,8 @@ import SubpathSetupSteps from "/snippets/es/subpath-setup-steps.mdx";
Para publicar tu documentación a través de un proxy inverso personalizado, debes configurar reglas de enrutamiento, políticas de caché y reenvío de encabezados.
+Las rutas de enrutamiento, los métodos HTTP y los requisitos de encabezados de esta página se aplican a cualquier proxy inverso. Las configuraciones de ejemplo usan Nginx. Adáptalas a otro proxy como Apache, Caddy o HAProxy traduciendo cada directiva a la sintaxis equivalente.
+
Al implementar un proxy inverso, supervisa posibles problemas con la verificación del dominio, el aprovisionamiento de certificados SSL, los flujos de autenticación, el rendimiento y el seguimiento de analíticas.
diff --git a/es/migration-services/go-live-checklist.mdx b/es/migration-services/go-live-checklist.mdx
index 1ae6c179a..ab3f086ef 100644
--- a/es/migration-services/go-live-checklist.mdx
+++ b/es/migration-services/go-live-checklist.mdx
@@ -33,7 +33,25 @@ Esta es una lista completa de configuraciones que debes establecer y ajustes que
- **Verifica tu arquitectura de la información.** ¿Es esta la estructura de navegación adecuada? ¿Faltan secciones? Consulta [tipos de contenido](/es/guides/content-types) como referencia.
- **Verifica que tu información esté actualizada.** ¿Se reflejan todos los cambios de contenido recientes en tu sitio?
-- Si es necesario, configura [redirecciones](/es/create/redirects).
+- Si es necesario, configura [redirecciones](/es/create/redirects). Prueba cada redirección en un navegador para confirmar que devuelve el destino esperado.
+
+
+ ## Verificación de seguridad
+
+
+- Verifica el [SSO del panel](/es/dashboard/sso) iniciando sesión como usuario de prueba desde tu proveedor de identidad.
+- Verifica el [aprovisionamiento SCIM](/es/dashboard/scim) aprovisionando un usuario de prueba y confirmando que aparezca en la lista de miembros de tu panel.
+- Verifica la [autenticación](/es/deploy/authentication-setup) del sitio iniciando sesión como miembro de cada grupo de acceso y confirmando que las páginas restringidas sean visibles solo para los grupos esperados.
+
+
+ ## SEO
+
+
+- Revisa los títulos de página, descripciones y encabezados de las páginas con más tráfico. Consulta [Cómo mejorar el SEO de la documentación](/es/guides/seo).
+- Confirma que tu sitemap sea accesible en `https://
/sitemap.xml`.
+- Envía tu sitemap a [Google Search Console](https://search.google.com/search-console) y a cualquier otra consola de búsqueda que uses.
+- Elimina `noindex: true` de cualquier página que se haya ocultado de la búsqueda durante el staging pero que deba ser detectable en el lanzamiento.
+- Configura imágenes OG y metaetiquetas específicas por página para las páginas que esperas que se compartan. Consulta [SEO](/es/optimize/seo).
## Funciones del panel
@@ -53,3 +71,6 @@ Esta es una lista completa de configuraciones que debes establecer y ajustes que
- **Configura tu dominio personalizado.** Consulta la [guía de dominios personalizados](/es/customize/custom-domain).
+- **Verifica que el DNS resuelva** hacia tu sitio de Mintlify desde el dominio personalizado.
+- **Verifica que el certificado TLS** sea válido y no haya expirado.
+- **Verifica las redirecciones del dominio anterior** para asegurarte de que envíen a los visitantes a las páginas correctas en el nuevo dominio.
diff --git a/es/organize/related-pages.mdx b/es/organize/related-pages.mdx
index 5c507caa4..d1b119d9b 100644
--- a/es/organize/related-pages.mdx
+++ b/es/organize/related-pages.mdx
@@ -96,6 +96,17 @@ En el modo **Automático**, las páginas relacionadas se generan a partir del í
Para las implementaciones con [autenticación de usuario final](/es/deploy/authentication-setup), las sugerencias automáticas están deshabilitadas para evitar filtrar contenido entre contextos de usuario. Usa el campo de frontmatter `related` para mostrar sugerencias seleccionadas en implementaciones autenticadas por usuario.
+
+ ## Cuando las sugerencias no aparecen
+
+
+Si la sección **Temas relacionados** aparece vacía en una página en el modo **Automático**:
+
+- El índice de búsqueda puede que aún no esté listo. Las sugerencias automáticas se reconstruyen después de cada despliegue, así que espera unos minutos después de publicar contenido nuevo y recarga la página.
+- Es posible que tu documentación no contenga suficiente contenido similar para que Mintlify pueda recomendar. Las sugerencias automáticas se obtienen del mismo idioma y versión de la página, por lo que un conjunto pequeño de documentos o una localización poco poblada puede no devolver coincidencias.
+- La autenticación de usuario final está habilitada. En su lugar, selecciona sugerencias con el campo de frontmatter `related`.
+- La página usa `related: false` y la sección está oculta intencionalmente.
+
## Recursos relacionados
diff --git a/fr/assistant/widget.mdx b/fr/assistant/widget.mdx
index 8171111ad..2ed0cf4a9 100644
--- a/fr/assistant/widget.mdx
+++ b/fr/assistant/widget.mdx
@@ -144,6 +144,21 @@ La modification de `identity` démarre une nouvelle conversation. La modificatio
Vous pouvez fournir `supportEmail` et `starterQuestions` lors de l'initialisation et les modifier ultérieurement avec `update()`. Ces valeurs s'appliquent à l'intégration en cours et ne sont pas héritées de votre tableau de bord Mintlify.
+
+ ## Authentifier les utilisateurs finaux
+
+
+Passez un jeton `identity` signé à `init()` ou `update()` pour associer une session du widget à un utilisateur final spécifique. Omettez `identity` pour les visiteurs anonymes.
+
+Les jetons d'identité ne sont vérifiés que lorsque votre déploiement est configuré avec l'[authentification JWT](/fr/deploy/authentication-setup). Signez chaque jeton sur votre serveur avec la même clé privée que vous avez enregistrée sur la page [Authentification](https://app.mintlify.com/settings/deployment/authentication) de votre tableau de bord, et incluez les revendications suivantes :
+
+- `sub` : un identifiant stable pour l'utilisateur final.
+- `aud` : l'ID du widget.
+- `iat` : la date d'émission du jeton.
+- `exp` : la date d'expiration du jeton. Gardez une durée de vie courte et renouvelez les jetons depuis votre backend avant leur expiration.
+
+Signez les jetons avec `EdDSA` ou `ES256`. N'exposez jamais votre clé privée et ne générez jamais de jetons dans le navigateur.
+
## Référence de configuration
diff --git a/fr/deploy/reverse-proxy.mdx b/fr/deploy/reverse-proxy.mdx
index c90095b8c..756d1e00b 100644
--- a/fr/deploy/reverse-proxy.mdx
+++ b/fr/deploy/reverse-proxy.mdx
@@ -1,6 +1,6 @@
---
title: "Proxy inverse"
-description: "Configurez un proxy inverse personnalisé avec Nginx, Apache ou Caddy pour servir votre documentation Mintlify sur un sous-chemin de votre propre domaine."
+description: "Configurez un proxy inverse personnalisé avec des règles de routage Nginx, la mise en cache et la transmission des en-têtes pour servir la documentation Mintlify sur un sous-chemin de votre propre domaine."
keywords: ["configuration de proxy inverse", "nginx", "routage du proxy", "transmission des en-têtes"]
---
@@ -8,6 +8,8 @@ import SubpathSetupSteps from "/snippets/fr/subpath-setup-steps.mdx";
Pour diffuser votre documentation via un proxy inverse personnalisé, vous devez configurer des règles de routage, des stratégies de mise en cache et la transmission des en-têtes.
+Les chemins de routage, les méthodes HTTP et les exigences d'en-têtes présentés sur cette page s'appliquent à n'importe quel proxy inverse. Les exemples de configuration utilisent Nginx. Adaptez-les à un autre proxy tel qu'Apache, Caddy ou HAProxy en traduisant chaque directive vers la syntaxe équivalente.
+
Lorsque vous mettez en place un proxy inverse, surveillez les problèmes potentiels liés à la vérification du domaine, à l’émission des certificats SSL, aux parcours d’authentification, aux performances et au suivi Analytics.
diff --git a/fr/migration-services/go-live-checklist.mdx b/fr/migration-services/go-live-checklist.mdx
index aa8a9ea2d..0e01009f9 100644
--- a/fr/migration-services/go-live-checklist.mdx
+++ b/fr/migration-services/go-live-checklist.mdx
@@ -33,7 +33,25 @@ Voici une liste complète des configurations à mettre en place et des paramètr
- **Vérifiez votre architecture de l'information.** La structure de navigation est-elle appropriée ? Manque-t-il des sections ? Consultez les [types de contenu](/fr/guides/content-types) pour référence.
- **Vérifiez que vos informations sont à jour.** Toutes les modifications récentes de contenu sont-elles reflétées sur votre site ?
-- Si nécessaire, configurez des [redirections](/fr/create/redirects).
+- Si nécessaire, configurez des [redirections](/fr/create/redirects). Testez chaque redirection dans un navigateur pour confirmer qu'elle renvoie vers la destination attendue.
+
+
+ ## Vérification de la sécurité
+
+
+- Vérifiez le [SSO du tableau de bord](/fr/dashboard/sso) en vous connectant en tant qu'utilisateur test depuis votre fournisseur d'identité.
+- Vérifiez le [provisionnement SCIM](/fr/dashboard/scim) en provisionnant un utilisateur test et en confirmant qu'il apparaît dans la liste des membres de votre tableau de bord.
+- Vérifiez l'[authentification](/fr/deploy/authentication-setup) du site en vous connectant en tant que membre de chaque groupe d'accès et en confirmant que les pages restreintes ne sont visibles que par les groupes attendus.
+
+
+ ## SEO
+
+
+- Passez en revue les titres, descriptions et en-têtes des pages à plus fort trafic. Consultez [Comment améliorer le SEO de la documentation](/fr/guides/seo).
+- Confirmez que votre sitemap est accessible à l'adresse `https://
/sitemap.xml`.
+- Soumettez votre sitemap à [Google Search Console](https://search.google.com/search-console) et à toute autre console de recherche que vous utilisez.
+- Retirez `noindex: true` de toute page qui a été masquée à la recherche pendant la phase de staging mais qui devrait être découvrable au lancement.
+- Définissez les images OG et les balises meta spécifiques aux pages que vous prévoyez de voir partagées. Consultez [SEO](/fr/optimize/seo).
## Fonctionnalités du tableau de bord
@@ -53,3 +71,6 @@ Voici une liste complète des configurations à mettre en place et des paramètr
- **Définissez votre domaine personnalisé.** Consultez le [guide sur le domaine personnalisé](/fr/customize/custom-domain).
+- **Vérifiez que le DNS résout** vers votre site Mintlify depuis le domaine personnalisé.
+- **Vérifiez que le certificat TLS** est valide et n'est pas expiré.
+- **Vérifiez les redirections depuis l'ancien domaine** en confirmant qu'elles envoient les visiteurs vers les bonnes pages sur le nouveau domaine.
diff --git a/fr/organize/related-pages.mdx b/fr/organize/related-pages.mdx
index 1632d6225..5249ef3c3 100644
--- a/fr/organize/related-pages.mdx
+++ b/fr/organize/related-pages.mdx
@@ -96,6 +96,17 @@ En mode **Automatic**, les pages associées sont générées à partir de l'inde
Pour les déploiements avec [authentification des utilisateurs finaux](/fr/deploy/authentication-setup), les suggestions automatiques sont désactivées afin d'éviter les fuites de contenu entre contextes utilisateur. Utilisez le champ de frontmatter `related` pour afficher des suggestions sélectionnées sur les déploiements avec authentification utilisateur.
+
+ ## Lorsque les suggestions n'apparaissent pas
+
+
+Si la section **Sujets associés** est vide sur une page en mode **Automatic** :
+
+- L'index de recherche n'est peut-être pas encore prêt. Les suggestions automatiques sont reconstruites après chaque déploiement, donc attendez quelques minutes après la publication du nouveau contenu et rechargez la page.
+- Votre documentation ne contient peut-être pas assez de contenu similaire pour que Mintlify puisse faire des recommandations. Les suggestions automatiques sont tirées de la même langue et version que la page, donc un petit ensemble de documentation ou une locale peu remplie peut ne renvoyer aucun résultat.
+- L'authentification des utilisateurs finaux est activée. Sélectionnez les suggestions avec le champ de frontmatter `related` à la place.
+- La page utilise `related: false` et la section est masquée intentionnellement.
+
## Ressources associées
diff --git a/migration-services/go-live-checklist.mdx b/migration-services/go-live-checklist.mdx
index e03a9f530..8b2b56d85 100644
--- a/migration-services/go-live-checklist.mdx
+++ b/migration-services/go-live-checklist.mdx
@@ -27,7 +27,21 @@ This is a comprehensive list of configurations to set up and settings to validat
- **Verify your information architecture.** Is this the proper navigation structure? Are there missing sections? See [content types](/guides/content-types) for reference.
- **Verify your information is up-to-date.** Are all recent content changes reflected on your site?
-- If required, set up [redirects](/create/redirects).
+- If required, set up [redirects](/create/redirects). Test each redirect in a browser to confirm it returns the expected destination.
+
+## Security verification
+
+- Verify [dashboard SSO](/dashboard/sso) by signing in as a test user from your identity provider.
+- Verify [SCIM provisioning](/dashboard/scim) by provisioning a test user and confirming they appear in your dashboard members list.
+- Verify site [authentication](/deploy/authentication-setup) by signing in as a member of each access group and confirming that restricted pages are visible only to the expected groups.
+
+## SEO
+
+- Review page titles, descriptions, and headings for the highest-traffic pages. See [How to improve documentation SEO](/guides/seo).
+- Confirm your sitemap is reachable at `https:///sitemap.xml`.
+- Submit your sitemap to [Google Search Console](https://search.google.com/search-console) and any other search consoles you use.
+- Remove `noindex: true` from any pages that were hidden from search during staging but should be discoverable at launch.
+- Set OG images and page-specific meta tags for the pages you expect to be shared. See [SEO](/optimize/seo).
## Dashboard features
@@ -43,3 +57,6 @@ This is a comprehensive list of configurations to set up and settings to validat
## Go live
- **Set your custom domain.** See the [custom domain guide](/customize/custom-domain).
+- **Verify DNS resolves** to your Mintlify site from the custom domain.
+- **Verify the TLS certificate** is valid and not expired.
+- **Verify old-domain redirects** send visitors to the correct pages on the new domain.
diff --git a/organize/related-pages.mdx b/organize/related-pages.mdx
index 4bcddef70..0574c0b62 100644
--- a/organize/related-pages.mdx
+++ b/organize/related-pages.mdx
@@ -82,3 +82,12 @@ In **Automatic** mode, related pages are generated from your docs' search index
For deployments with [end-user authentication](/deploy/authentication-setup), automatic suggestions are disabled to avoid leaking content across user contexts. Use the `related` frontmatter field to show curated suggestions on user-authenticated deployments.
+## When suggestions don't appear
+
+If the **Related topics** section is empty on a page in **Automatic** mode:
+
+- The search index may not be ready yet. Automatic suggestions rebuild after each deploy, so wait a few minutes after publishing new content and reload the page.
+- Your docs may not contain enough similar content for Mintlify to recommend. Automatic suggestions are drawn from the same page's language and version, so a small docs set or a lightly-populated locale can return no matches.
+- End-user authentication is enabled. Curate suggestions with the `related` frontmatter field instead.
+- The page uses `related: false` and the section is hidden intentionally.
+
diff --git a/zh/assistant/widget.mdx b/zh/assistant/widget.mdx
index 9fdc55bec..30178f418 100644
--- a/zh/assistant/widget.mdx
+++ b/zh/assistant/widget.mdx
@@ -144,6 +144,21 @@ await window.MintlifyAssistant.update({
你可以在初始化时提供 `supportEmail` 和 `starterQuestions`,也可以稍后通过 `update()` 更改。这些值仅作用于当前嵌入,不会继承自你的 Mintlify 仪表板。
+
+ ## 对终端用户进行身份验证
+
+
+向 `init()` 或 `update()` 传入已签名的 `identity` 令牌,可以将小组件会话与特定的终端用户关联。对于匿名访客,请省略 `identity`。
+
+仅当你的部署配置了 [JWT 身份验证](/zh/deploy/authentication-setup)时,身份令牌才会被验证。请使用你在仪表板的[身份验证](https://app.mintlify.com/settings/deployment/authentication)页面上注册的同一把私钥,在你的服务器上为每个令牌签名,并包含以下声明:
+
+- `sub`:终端用户的稳定标识符。
+- `aud`:小组件 ID。
+- `iat`:令牌签发时间。
+- `exp`:令牌过期时间。请保持较短的有效期,并在令牌过期前通过你的后端刷新。
+
+使用 `EdDSA` 或 `ES256` 对令牌签名。切勿泄露你的私钥,也不要在浏览器中生成令牌。
+
## 配置参考
diff --git a/zh/deploy/reverse-proxy.mdx b/zh/deploy/reverse-proxy.mdx
index 1e6a768b5..be4a3040c 100644
--- a/zh/deploy/reverse-proxy.mdx
+++ b/zh/deploy/reverse-proxy.mdx
@@ -1,6 +1,6 @@
---
title: "反向代理"
-description: "使用 Nginx、Apache 或 Caddy 配置自定义反向代理,在你自己的域名子路径上提供 Mintlify 文档服务。"
+description: "使用 Nginx 路由规则、缓存和请求头转发配置自定义反向代理,在你自己的域名子路径上提供 Mintlify 文档服务。"
keywords: ["反向代理配置","nginx","代理路由","请求头转发"]
---
@@ -8,6 +8,8 @@ import SubpathSetupSteps from "/snippets/zh/subpath-setup-steps.mdx";
要通过自定义反向代理提供文档服务,你需要配置路由规则、缓存策略和请求头转发。
+本页中的路由路径、HTTP 方法和请求头要求适用于任何反向代理。示例配置使用的是 Nginx。如需改用其他代理(如 Apache、Caddy 或 HAProxy),请将每条指令替换为对应的等价语法。
+
在实施反向代理时,请留意可能出现的域名验证、SSL 证书签发、认证流程、性能以及分析追踪相关的问题。
diff --git a/zh/migration-services/go-live-checklist.mdx b/zh/migration-services/go-live-checklist.mdx
index 488cb74e0..8feb849f8 100644
--- a/zh/migration-services/go-live-checklist.mdx
+++ b/zh/migration-services/go-live-checklist.mdx
@@ -33,7 +33,25 @@ noindex: true
- **验证您的信息架构。** 这是合适的导航结构吗?是否有缺失的部分?请参阅[内容类型](/zh/guides/content-types)以获取参考。
- **验证您的信息是最新的。** 所有最近的内容更改是否都反映在您的站点上?
-- 如有需要,请设置[重定向](/zh/create/redirects)。
+- 如有需要,请设置[重定向](/zh/create/redirects)。在浏览器中测试每一条重定向,确认其返回预期的目标地址。
+
+
+ ## 安全验证
+
+
+- 通过以身份提供方中的测试用户登录,验证[仪表板 SSO](/zh/dashboard/sso)。
+- 通过配置一个测试用户并确认其出现在仪表板成员列表中,验证 [SCIM 配置](/zh/dashboard/scim)。
+- 通过以每个访问组的成员身份登录,并确认受限页面仅对预期的用户组可见,验证站点[身份验证](/zh/deploy/authentication-setup)。
+
+
+ ## SEO
+
+
+- 审查流量最高页面的标题、描述和标题层级。请参阅[如何优化文档 SEO](/zh/guides/seo)。
+- 确认可以通过 `https://
/sitemap.xml` 访问你的站点地图。
+- 将你的站点地图提交至 [Google Search Console](https://search.google.com/search-console) 以及你使用的其他任何搜索控制台。
+- 从任何在预发布期间被隐藏但应在上线时可被搜索到的页面中移除 `noindex: true`。
+- 为你预计会被分享的页面设置 OG 图片和页面专属的元标签。请参阅 [SEO](/zh/optimize/seo)。
## 仪表板功能
@@ -53,3 +71,6 @@ noindex: true
- **设置您的自定义域名。** 请参阅[自定义域名指南](/zh/customize/custom-domain)。
+- **验证 DNS 解析**从自定义域名指向你的 Mintlify 站点。
+- **验证 TLS 证书**有效且未过期。
+- **验证旧域名的重定向**能将访客引导至新域名上正确的页面。
diff --git a/zh/organize/related-pages.mdx b/zh/organize/related-pages.mdx
index 23e56c91f..04abe3c16 100644
--- a/zh/organize/related-pages.mdx
+++ b/zh/organize/related-pages.mdx
@@ -96,6 +96,17 @@ related: false
对于启用了[终端用户认证](/zh/deploy/authentication-setup)的部署,自动推荐会被禁用,以避免跨用户上下文泄露内容。在启用了用户认证的部署上,请使用 `related` frontmatter 字段来展示经过整理的推荐。
+
+ ## 当推荐未显示时
+
+
+如果在 **Automatic** 模式下,某个页面的 **相关主题** 部分为空:
+
+- 搜索索引可能尚未就绪。自动推荐会在每次部署后重建,因此请在发布新内容后等待几分钟再重新加载页面。
+- 你的文档中可能没有足够多的相似内容供 Mintlify 推荐。自动推荐仅从同一页面的语言和版本中抽取,因此文档规模较小或某个语言环境内容较少时,可能返回不到匹配结果。
+- 已启用终端用户认证。请改用 `related` frontmatter 字段来整理推荐。
+- 页面使用了 `related: false`,该部分被有意隐藏。
+
## 相关资源