From bf06d346ab05b46dd6f2daa0759a0027dfda7805 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 28 Aug 2026 10:11:48 +0000 Subject: [PATCH 1/2] docs: fix quality gaps in recently updated pages --- deploy/cloudflare.mdx | 2 +- guides/use-automations.mdx | 3 ++- integrations/analytics/google-tag-manager.mdx | 4 ++++ migration-services/go-live-checklist.mdx | 2 +- 4 files changed, 8 insertions(+), 3 deletions(-) diff --git a/deploy/cloudflare.mdx b/deploy/cloudflare.mdx index 81338540f..49fda4198 100644 --- a/deploy/cloudflare.mdx +++ b/deploy/cloudflare.mdx @@ -293,7 +293,7 @@ Rule: Allow Mintlify assets Status: Enabled When incoming requests match: - (http.host eq "docs.flashnet.xyz" and starts_with(http.request.uri.path, "/mintlify-assets/")) + (http.host eq "docs.yourdomain.com" and starts_with(http.request.uri.path, "/mintlify-assets/")) Then: Skip: All remaining custom rules, Managed rules, Super Bot Fight Mode diff --git a/guides/use-automations.mdx b/guides/use-automations.mdx index baf1f94d4..bbf382d61 100644 --- a/guides/use-automations.mdx +++ b/guides/use-automations.mdx @@ -18,13 +18,14 @@ For one-off or exploratory tasks, use the agent directly in the [dashboard](http ## Choose a trigger -Each automation runs on one of three trigger types. Choose the one that matches when you need the work done. +Each automation runs on one of four trigger types. Choose the one that matches when you need the work done. | Trigger | Use when | |---|---| | Content update | The task should run whenever your project content changes—translating new pages, fixing broken links, or auditing SEO metadata. | | Code change | The task should run when source code changes—updating API specifications or documentation after a PR merges. | | Custom schedule | The task should run on a fixed cadence regardless—publishing weekly changelogs or running periodic grammar checks. | +| Integration | The task should run when an event occurs in a connected tool—responding to a new message in a Slack channel. Available for custom automations. | ## Predefined automations diff --git a/integrations/analytics/google-tag-manager.mdx b/integrations/analytics/google-tag-manager.mdx index 81f12b6f5..4b0420a68 100644 --- a/integrations/analytics/google-tag-manager.mdx +++ b/integrations/analytics/google-tag-manager.mdx @@ -6,8 +6,12 @@ keywords: ["GTM integration", "tag management", "tag ID", "cookie consent"] Add your tag ID to your `docs.json` file and Mintlify injects the Google Tag Manager script into all your pages. +Your tag ID is the container ID displayed in your Google Tag Manager workspace, formatted as `GTM-XXXXXXX`. + You are responsible for setting up cookie consent banners with Google Tag Manager if you need them. +After publishing your changes, use Google Tag Manager's preview mode to confirm that your container loads on your docs site. + ```json Analytics options in docs.json diff --git a/migration-services/go-live-checklist.mdx b/migration-services/go-live-checklist.mdx index 4e7da36cd..28ae7321d 100644 --- a/migration-services/go-live-checklist.mdx +++ b/migration-services/go-live-checklist.mdx @@ -8,7 +8,7 @@ Use this checklist to set up configurations and validate settings before going l ## Core setup -- **Add content to your repo.** If using Mintlify's migration services, upload the zip of the content to your repository. +- **Add content to your repo.** If using Mintlify's [migration services](/migration-services/enterprise), extract the zip of migrated content that Mintlify delivers and add the files to your repository. - **Connect your docs repo to Mintlify.** Install the [GitHub App](/deploy/github), connect your [GitLab repository](/deploy/gitlab), or connect your [Bitbucket Cloud repository](/deploy/bitbucket). - If you store your documentation in more than one repository, configure a [multi-repository structure](/deploy/multi-repo) to build your site from multiple repos. If all of your content is in a single repository, skip this step. - **Invite team members.** Invite anyone who needs access from the [Members](https://app.mintlify.com/settings/organization/members) page in your dashboard. See [Roles](/dashboard/roles) for more information. From 1a5796770e2fd5680adf95a57576cdbb8f020d24 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Fri, 28 Aug 2026 10:15:14 +0000 Subject: [PATCH 2/2] docs: mirror quality fixes into es, fr, zh translations --- es/deploy/cloudflare.mdx | 2 +- es/guides/use-automations.mdx | 3 ++- es/integrations/analytics/google-tag-manager.mdx | 4 ++++ es/migration-services/go-live-checklist.mdx | 2 +- fr/deploy/cloudflare.mdx | 2 +- fr/guides/use-automations.mdx | 3 ++- fr/integrations/analytics/google-tag-manager.mdx | 4 ++++ fr/migration-services/go-live-checklist.mdx | 2 +- zh/deploy/cloudflare.mdx | 2 +- zh/guides/use-automations.mdx | 3 ++- zh/integrations/analytics/google-tag-manager.mdx | 4 ++++ zh/migration-services/go-live-checklist.mdx | 2 +- 12 files changed, 24 insertions(+), 9 deletions(-) diff --git a/es/deploy/cloudflare.mdx b/es/deploy/cloudflare.mdx index cc23778ce..e91df5598 100644 --- a/es/deploy/cloudflare.mdx +++ b/es/deploy/cloudflare.mdx @@ -334,7 +334,7 @@ Rule: Allow Mintlify assets Status: Enabled When incoming requests match: - (http.host eq "docs.flashnet.xyz" and starts_with(http.request.uri.path, "/mintlify-assets/")) + (http.host eq "docs.yourdomain.com" and starts_with(http.request.uri.path, "/mintlify-assets/")) Then: Skip: All remaining custom rules, Managed rules, Super Bot Fight Mode diff --git a/es/guides/use-automations.mdx b/es/guides/use-automations.mdx index ef3a3af97..cb9dc91e9 100644 --- a/es/guides/use-automations.mdx +++ b/es/guides/use-automations.mdx @@ -22,13 +22,14 @@ Para tareas puntuales o exploratorias, usa el agente directamente en el [dashboa ## Elige un activador -Cada automatización se ejecuta con uno de tres tipos de activadores. Elige el que se ajuste a cuándo necesitas que se realice el trabajo. +Cada automatización se ejecuta con uno de cuatro tipos de activadores. Elige el que se ajuste a cuándo necesitas que se realice el trabajo. | Activador | Úsalo cuando | |---|---| | Actualización de contenido | La tarea debe ejecutarse siempre que cambie el contenido de tu proyecto: traducir nuevas páginas, corregir enlaces rotos o auditar metadatos de SEO. | | Cambio de código | La tarea debe ejecutarse cuando cambia el código fuente: actualizar especificaciones de API o documentación después de fusionar una PR. | | Programación personalizada | La tarea debe ejecutarse con una cadencia fija independientemente de otros eventos: publicar registros de cambios semanales o ejecutar comprobaciones gramaticales periódicas. | +| Integración | La tarea debe ejecutarse cuando ocurre un evento en una herramienta conectada: responder a un nuevo mensaje en un canal de Slack. Disponible para automatizaciones personalizadas. |
## Automatizaciones predefinidas diff --git a/es/integrations/analytics/google-tag-manager.mdx b/es/integrations/analytics/google-tag-manager.mdx index c8ed220ff..58e7194ff 100644 --- a/es/integrations/analytics/google-tag-manager.mdx +++ b/es/integrations/analytics/google-tag-manager.mdx @@ -6,8 +6,12 @@ keywords: ["integración con GTM", "gestión de etiquetas", "ID de etiqueta", "c Añade tu ID de etiqueta en el archivo `docs.json` y inyectaremos el script de Google Tag Manager en todas tus páginas. +Tu ID de etiqueta es el ID del contenedor que se muestra en tu espacio de trabajo de Google Tag Manager, con el formato `GTM-XXXXXXX`. + Tú eres responsable de configurar los banners de consentimiento de cookies con Google Tag Manager si los necesitas. +Después de publicar tus cambios, usa el modo de vista previa de Google Tag Manager para confirmar que tu contenedor se carga en tu sitio de documentación. + ```json Opciones de Analytics en docs.json diff --git a/es/migration-services/go-live-checklist.mdx b/es/migration-services/go-live-checklist.mdx index c46d557ed..ac3719bba 100644 --- a/es/migration-services/go-live-checklist.mdx +++ b/es/migration-services/go-live-checklist.mdx @@ -10,7 +10,7 @@ Esta es una lista completa de configuraciones que debes establecer y ajustes que ## Configuración básica
-- **Agrega el contenido a tu repositorio.** Si utilizas los servicios de migración de Mintlify, sube el archivo zip con el contenido a tu repositorio. +- **Agrega el contenido a tu repositorio.** Si utilizas los [servicios de migración](/es/migration-services/enterprise) de Mintlify, extrae el archivo zip con el contenido migrado que entrega Mintlify y agrega los archivos a tu repositorio. - **Conecta tu repositorio de documentación a Mintlify.** Instala la [aplicación de GitHub](/es/deploy/github) o conecta tu [repositorio de GitLab](/es/deploy/gitlab), o conecta tu [repositorio de Bitbucket Cloud](/es/deploy/bitbucket). - Si almacenas tu documentación en más de un repositorio, configura una [estructura de múltiples repositorios](/es/deploy/multi-repo) para construir tu sitio a partir de varios repositorios. Si todo tu contenido está en un solo repositorio, omite este paso. - **Invita a los miembros del equipo.** Invita a cualquier persona que necesite acceso desde la página [Miembros](https://app.mintlify.com/settings/organization/members) en tu panel. Consulta [Roles](/es/dashboard/roles) para obtener más información. diff --git a/fr/deploy/cloudflare.mdx b/fr/deploy/cloudflare.mdx index f9dee82b8..05e951092 100644 --- a/fr/deploy/cloudflare.mdx +++ b/fr/deploy/cloudflare.mdx @@ -336,7 +336,7 @@ Rule: Allow Mintlify assets Status: Enabled When incoming requests match: - (http.host eq "docs.flashnet.xyz" and starts_with(http.request.uri.path, "/mintlify-assets/")) + (http.host eq "docs.yourdomain.com" and starts_with(http.request.uri.path, "/mintlify-assets/")) Then: Skip: All remaining custom rules, Managed rules, Super Bot Fight Mode diff --git a/fr/guides/use-automations.mdx b/fr/guides/use-automations.mdx index 27b846797..d4fc74733 100644 --- a/fr/guides/use-automations.mdx +++ b/fr/guides/use-automations.mdx @@ -22,13 +22,14 @@ Pour les tâches ponctuelles ou exploratoires, utilisez l'agent directement dans ## Choisir un déclencheur -Chaque automatisation s'exécute selon l'un des trois types de déclencheurs. Choisissez celui qui correspond au moment où vous avez besoin que le travail soit effectué. +Chaque automatisation s'exécute selon l'un des quatre types de déclencheurs. Choisissez celui qui correspond au moment où vous avez besoin que le travail soit effectué. | Déclencheur | À utiliser lorsque | |---|---| | Mise à jour de contenu | La tâche doit s'exécuter chaque fois que le contenu de votre projet change — traduction de nouvelles pages, correction de liens cassés ou audit des métadonnées SEO. | | Modification de code | La tâche doit s'exécuter lorsque le code source change — mise à jour des spécifications d'API ou de la documentation après la fusion d'une PR. | | Calendrier personnalisé | La tâche doit s'exécuter à une cadence fixe, quoi qu'il arrive — publication de changelogs hebdomadaires ou vérifications grammaticales périodiques. | +| Intégration | La tâche doit s'exécuter lorsqu'un événement se produit dans un outil connecté — réponse à un nouveau message dans un canal Slack. Disponible pour les automatisations personnalisées. |
## Automatisations prédéfinies diff --git a/fr/integrations/analytics/google-tag-manager.mdx b/fr/integrations/analytics/google-tag-manager.mdx index 20ad0f274..183f530ab 100644 --- a/fr/integrations/analytics/google-tag-manager.mdx +++ b/fr/integrations/analytics/google-tag-manager.mdx @@ -6,8 +6,12 @@ keywords: ["intégration GTM", "gestion des balises", "ID de balise", "consentem Ajoutez votre ID de balise dans le fichier `docs.json` et nous injecterons le script Google Tag Manager sur toutes vos pages. +Votre ID de balise est l'ID du conteneur affiché dans votre espace de travail Google Tag Manager, au format `GTM-XXXXXXX`. + Vous êtes responsable de la mise en place des bandeaux de consentement aux cookies avec Google Tag Manager si nécessaire. +Après avoir publié vos modifications, utilisez le mode aperçu de Google Tag Manager pour confirmer que votre conteneur se charge sur votre site de documentation. + ```json Options d’Analytics dans docs.json diff --git a/fr/migration-services/go-live-checklist.mdx b/fr/migration-services/go-live-checklist.mdx index a5cfe9662..bfcdb6a46 100644 --- a/fr/migration-services/go-live-checklist.mdx +++ b/fr/migration-services/go-live-checklist.mdx @@ -10,7 +10,7 @@ Cette liste récapitule les configurations à mettre en place et les paramètres ## Configuration de base
-- **Ajoutez le contenu à votre dépôt.** Si vous utilisez les services de migration de Mintlify, téléversez le fichier zip du contenu dans votre dépôt. +- **Ajoutez le contenu à votre dépôt.** Si vous utilisez les [services de migration](/fr/migration-services/enterprise) de Mintlify, extrayez le fichier zip du contenu migré livré par Mintlify et ajoutez les fichiers à votre dépôt. - **Connectez votre dépôt de documentation à Mintlify.** Installez l'[application GitHub](/fr/deploy/github) ou connectez votre [dépôt GitLab](/fr/deploy/gitlab), ou connectez votre [dépôt Bitbucket Cloud](/fr/deploy/bitbucket). - Si vous stockez votre documentation dans plusieurs dépôts, configurez une [structure multi-dépôts](/fr/deploy/multi-repo) pour créer votre site à partir de plusieurs dépôts. Si tout votre contenu se trouve dans un seul dépôt, ignorez cette étape. - **Invitez les membres de votre équipe.** Invitez toute personne qui a besoin d'un accès depuis la page [Membres](https://app.mintlify.com/settings/organization/members) de votre tableau de bord. Consultez [Rôles](/fr/dashboard/roles) pour plus d'informations. diff --git a/zh/deploy/cloudflare.mdx b/zh/deploy/cloudflare.mdx index a796bbba3..2f021a0fb 100644 --- a/zh/deploy/cloudflare.mdx +++ b/zh/deploy/cloudflare.mdx @@ -336,7 +336,7 @@ Rule: Allow Mintlify assets Status: Enabled When incoming requests match: - (http.host eq "docs.flashnet.xyz" and starts_with(http.request.uri.path, "/mintlify-assets/")) + (http.host eq "docs.yourdomain.com" and starts_with(http.request.uri.path, "/mintlify-assets/")) Then: Skip: All remaining custom rules, Managed rules, Super Bot Fight Mode diff --git a/zh/guides/use-automations.mdx b/zh/guides/use-automations.mdx index b110328c7..a13e2e4a2 100644 --- a/zh/guides/use-automations.mdx +++ b/zh/guides/use-automations.mdx @@ -22,13 +22,14 @@ keywords: ["automations", "automation", "automate", "automation guide", "automat ## 选择触发器 -每个自动化都基于三种触发器类型之一运行。选择与你需要的工作完成时机相匹配的触发器。 +每个自动化都基于四种触发器类型之一运行。选择与你需要的工作完成时机相匹配的触发器。 | 触发器 | 使用场景 | |---|---| | 内容更新（Content update） | 任务应在你的项目内容变更时运行——翻译新页面、修复失效链接或审计 SEO 元数据。 | | 代码变更（Code change） | 任务应在源代码变更时运行——在 PR 合并后更新 API 规范或文档。 | | 自定义计划（Custom schedule） | 任务应按固定节奏运行——发布每周更新日志或运行定期的语法检查。 | +| 集成（Integration） | 任务应在连接的工具中发生事件时运行——响应 Slack 频道中的新消息。适用于自定义自动化。 |
## 预定义自动化 diff --git a/zh/integrations/analytics/google-tag-manager.mdx b/zh/integrations/analytics/google-tag-manager.mdx index 20239eadb..c35b724fd 100644 --- a/zh/integrations/analytics/google-tag-manager.mdx +++ b/zh/integrations/analytics/google-tag-manager.mdx @@ -6,8 +6,12 @@ keywords: ["GTM integration", "tag management", "tag ID", "cookie consent"] 将你的 tag ID 添加到 `docs.json` 文件，我们会将 Google Tag Manager 脚本注入到你所有页面中。 +你的 tag ID 是 Google Tag Manager 工作区中显示的容器 ID，格式为 `GTM-XXXXXXX`。 + 如有需要，你需要通过 Google Tag Manager 配置 Cookie 同意横幅。 +发布更改后，使用 Google Tag Manager 的预览模式确认容器已在你的文档站点上加载。 + ```json docs.json 中的 Analytics 选项 diff --git a/zh/migration-services/go-live-checklist.mdx b/zh/migration-services/go-live-checklist.mdx index e7a6d5900..7bdfff7b3 100644 --- a/zh/migration-services/go-live-checklist.mdx +++ b/zh/migration-services/go-live-checklist.mdx @@ -10,7 +10,7 @@ noindex: true ## 核心设置
-- **将内容添加到你的代码库。** 如果使用 Mintlify 的迁移服务，请将内容的 zip 文件上传到你的代码库。 +- **将内容添加到你的代码库。** 如果使用 Mintlify 的[迁移服务](/zh/migration-services/enterprise)，请解压 Mintlify 交付的迁移内容 zip 文件，并将文件添加到你的代码库。 - **将文档代码库连接到 Mintlify。** 安装 [GitHub 应用](/zh/deploy/github)，或连接你的 [GitLab 代码库](/zh/deploy/gitlab)，或连接你的 [Bitbucket Cloud 代码库](/zh/deploy/bitbucket)。 - 如果你将文档存储在多个代码库中，请配置[多代码库结构](/zh/deploy/multi-repo)，以便从多个代码库构建网站。如果所有内容都在一个代码库中，请跳过此步骤。 - **邀请团队成员。** 在控制面板的[成员](https://app.mintlify.com/settings/organization/members)页面邀请需要访问权限的人员。有关更多信息，请参阅[角色](/zh/dashboard/roles)。