From 61df33c11dd0b57ce7d844465a679339a6c222f0 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 24 Sep 2026 15:11:07 +0000 Subject: [PATCH 1/3] docs: Vale style audit fixes for week ending Sep 24, 2026 --- .vale/styles/Mintlify/Acronyms.yml | 4 ++++ .vale/styles/Mintlify/WordList.yml | 2 +- .vale/styles/config/vocabularies/Mintlify/accept.txt | 2 ++ agent/slack.mdx | 4 ++-- analytics/traffic-classification.mdx | 2 +- automations/manage.mdx | 2 +- .../agent-opens-pull-requests-against-deploy-branch.mdx | 4 ++-- help-center/publish-button-disabled-invalid-mdx.mdx | 2 +- 8 files changed, 14 insertions(+), 8 deletions(-) diff --git a/.vale/styles/Mintlify/Acronyms.yml b/.vale/styles/Mintlify/Acronyms.yml index b8a8f8134e..ee5b2c417a 100644 --- a/.vale/styles/Mintlify/Acronyms.yml +++ b/.vale/styles/Mintlify/Acronyms.yml @@ -14,8 +14,10 @@ exceptions: - API - ASCII - ASP + - AVIF - AWS - BETA + - BMP - CAA - CDN - CIDR @@ -69,6 +71,7 @@ exceptions: - LTS - MCP - MDX + - MOV - NAT - NET - NEW @@ -96,6 +99,7 @@ exceptions: - ROI - RPC - RSA + - RSS - SAML - SCIM - SCM diff --git a/.vale/styles/Mintlify/WordList.yml b/.vale/styles/Mintlify/WordList.yml index 0e84196dda..f053de20bb 100644 --- a/.vale/styles/Mintlify/WordList.yml +++ b/.vale/styles/Mintlify/WordList.yml @@ -13,7 +13,7 @@ swap: '[\.]+apk': APK '3\-D': 3D "un(?:check|select)": clear - (?` header. Supply an unexpired organization API key with write access from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page. Use this to trigger a run from a CI/CD pipeline, release script, or internal tool. See [Trigger automation webhook](/api/automations/webhook) for the endpoint and rate limits. +- **Webhook**: Runs when an authenticated `POST` request hits the automation's webhook endpoint. Available for custom automations only. Save the automation first. The trigger card then shows the webhook URL and a **Copy auth header** action for the `Authorization: Bearer ` header. Supply an unexpired organization API key with write access from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page. Use this to trigger a run from a CI/CD pipeline, release script, or internal tool. See [Trigger automation webhook](/api/automations/webhook) for the endpoint and rate limits. #### Filter code change triggers diff --git a/help-center/agent-opens-pull-requests-against-deploy-branch.mdx b/help-center/agent-opens-pull-requests-against-deploy-branch.mdx index cf7290cc79..a672699bce 100644 --- a/help-center/agent-opens-pull-requests-against-deploy-branch.mdx +++ b/help-center/agent-opens-pull-requests-against-deploy-branch.mdx @@ -25,5 +25,5 @@ To stop automation PRs from merging without review, set the automation's update ## Related settings -- [Choose how the agent publishes changes](/agent/index#choose-how-the-agent-publishes-changes) — pull request vs. direct push, and how branch protection interacts with each. -- [Git Settings](https://app.mintlify.com/settings/project/git-settings) — change the deploy branch or the docs subdirectory the deployment builds from. +- [Choose how the agent publishes changes](/agent/index#choose-how-the-agent-publishes-changes)—pull request vs. direct push, and how branch protection interacts with each. +- [Git Settings](https://app.mintlify.com/settings/project/git-settings)—change the deploy branch or the docs subdirectory the deployment builds from. diff --git a/help-center/publish-button-disabled-invalid-mdx.mdx b/help-center/publish-button-disabled-invalid-mdx.mdx index 10bc2913f3..031474b3cf 100644 --- a/help-center/publish-button-disabled-invalid-mdx.mdx +++ b/help-center/publish-button-disabled-invalid-mdx.mdx @@ -19,7 +19,7 @@ While a page has invalid MDX or invalid frontmatter YAML, those edits stay local If the tooltip reports one broken page, it's usually the page you're editing. If it reports more than one, or you don't know which page has the error, check each page you've changed on the branch: 1. Click **Publish** in the toolbar to open the publish menu. The menu lists every changed file on your branch. -2. Open each changed file in turn and look for parsing errors in source mode (see below). Pages that parse successfully render normally; the broken page shows the error. +2. Open each changed file in turn and look for parsing errors in source mode (see below). Pages that parse successfully render normally. The broken page shows the error. ## Fix the error manually From 1d2d75f3fbe64e58063add249b54c5cb4631a828 Mon Sep 17 00:00:00 2001 From: "mintlify[bot]" <109931778+mintlify[bot]@users.noreply.github.com> Date: Thu, 24 Sep 2026 15:13:16 +0000 Subject: [PATCH 2/3] docs: mirror semicolon splits into es, fr, zh translations --- es/automations/manage.mdx | 2 +- es/help-center/publish-button-disabled-invalid-mdx.mdx | 2 +- fr/automations/manage.mdx | 2 +- fr/help-center/publish-button-disabled-invalid-mdx.mdx | 2 +- zh/automations/manage.mdx | 2 +- zh/help-center/publish-button-disabled-invalid-mdx.mdx | 2 +- 6 files changed, 6 insertions(+), 6 deletions(-) diff --git a/es/automations/manage.mdx b/es/automations/manage.mdx index 37d8a33b63..57ce3dad95 100644 --- a/es/automations/manage.mdx +++ b/es/automations/manage.mdx @@ -50,7 +50,7 @@ Cada automatización tiene un activador predeterminado que controla cuándo se e - **Cambio de código**: se ejecuta cuando se fusiona una pull request en un repositorio de código fuente conectado. Debes especificar al menos un repositorio de origen. Haz clic en **Add repo** para activar la automatización con pull requests de más de un repositorio. Para cada repositorio, puedes configurar opcionalmente **Exclude author** para ignorar pull requests de un autor específico, y **Listening to changes in** para activar el disparador solo con pull requests que tengan cambios bajo una ruta específica. - **Programación personalizada**: se ejecuta de forma recurrente según la programación que definas. Elige un preajuste (**Daily**, **Every Monday**, **Every Friday** o **Twice weekly**) y una hora de inicio, o selecciona **Custom cron** e introduce una expresión cron estándar de 5 campos (`minute hour day month weekday`). Los valores de cron se almacenan en UTC; el dashboard convierte las horas de los preajustes hacia y desde tu zona horaria local. Las automatizaciones se ponen en cola dentro de los 10 minutos siguientes a la hora programada. - **Integración**: se ejecuta cuando ocurre un evento seleccionado en una integración compartida conectada, o cuando se publica un nuevo mensaje de nivel superior en un canal de Slack seleccionado. Está disponible para automatizaciones personalizadas. Selecciona la integración y el evento y completa los campos adicionales que aparezcan. Para activadores de Slack, elige uno o más canales a los que se haya añadido la [app de Mintlify para Slack](/es/agent/slack). -- **Webhook**: se ejecuta cuando una solicitud `POST` autenticada llega al endpoint de webhook de la automatización. Solo está disponible para automatizaciones personalizadas. Guarda primero la automatización; la tarjeta del activador muestra entonces la URL del webhook y una acción **Copy auth header** para el encabezado `Authorization: Bearer `. Proporciona una clave de API de organización sin caducar con acceso de escritura desde la página [API keys](https://app.mintlify.com/settings/organization/api-keys). Úsalo para lanzar una ejecución desde un pipeline de CI/CD, un script de publicación o una herramienta interna. Consulta [Activar webhook de automatización](/es/api/automations/webhook) para conocer el endpoint y los límites de tasa. +- **Webhook**: se ejecuta cuando una solicitud `POST` autenticada llega al endpoint de webhook de la automatización. Solo está disponible para automatizaciones personalizadas. Guarda primero la automatización. La tarjeta del activador muestra entonces la URL del webhook y una acción **Copy auth header** para el encabezado `Authorization: Bearer `. Proporciona una clave de API de organización sin caducar con acceso de escritura desde la página [API keys](https://app.mintlify.com/settings/organization/api-keys). Úsalo para lanzar una ejecución desde un pipeline de CI/CD, un script de publicación o una herramienta interna. Consulta [Activar webhook de automatización](/es/api/automations/webhook) para conocer el endpoint y los límites de tasa.
#### Filtrar activadores de cambio de código diff --git a/es/help-center/publish-button-disabled-invalid-mdx.mdx b/es/help-center/publish-button-disabled-invalid-mdx.mdx index ed8b1b0d93..a7acca0133 100644 --- a/es/help-center/publish-button-disabled-invalid-mdx.mdx +++ b/es/help-center/publish-button-disabled-invalid-mdx.mdx @@ -21,7 +21,7 @@ Mientras una página tiene MDX no válido o YAML de frontmatter no válido, esas Si el tooltip indica una sola página con errores, normalmente es la que estás editando. Si indica más de una, o no sabes qué página tiene el error, revisa cada página que hayas modificado en la branch: 1. Haz clic en **Publish** en la barra de herramientas para abrir el menú de publicación. El menú lista todos los archivos modificados en tu branch. -2. Abre cada archivo modificado por turno y busca errores de parseo en el modo source (ver más abajo). Las páginas que se parsean correctamente se muestran con normalidad; la página rota muestra el error. +2. Abre cada archivo modificado por turno y busca errores de parseo en el modo source (ver más abajo). Las páginas que se parsean correctamente se muestran con normalidad. La página rota muestra el error.
## Corregir el error manualmente diff --git a/fr/automations/manage.mdx b/fr/automations/manage.mdx index 320907c627..b4845ecdc4 100644 --- a/fr/automations/manage.mdx +++ b/fr/automations/manage.mdx @@ -50,7 +50,7 @@ Chaque automatisation possède un déclencheur par défaut qui contrôle son mom - **Modification de code** : s'exécute lorsqu'une pull request est fusionnée dans un dépôt de code source connecté. Vous devez spécifier au moins un dépôt source. Cliquez sur **Add repo** pour déclencher l'automatisation sur des pull requests provenant de plusieurs dépôts. Pour chaque dépôt, vous pouvez éventuellement définir **Exclude author** pour ignorer les pull requests d'un auteur spécifique, et **Listening to changes in** pour ne déclencher que sur les pull requests dont les modifications se trouvent sous un chemin spécifique. - **Calendrier personnalisé** : s'exécute selon un calendrier récurrent que vous définissez. Choisissez un préréglage (**Daily**, **Every Monday**, **Every Friday** ou **Twice weekly**) et une heure de début, ou sélectionnez **Custom cron** et saisissez une expression cron standard à 5 champs (`minute heure jour mois jour_de_la_semaine`). Les valeurs cron sont stockées en UTC ; le dashboard convertit les heures des préréglages depuis et vers votre fuseau horaire local. Les automatisations sont mises en file d'attente dans les 10 minutes suivant l'heure planifiée. - **Intégration** : s'exécute lorsqu'un événement sélectionné se produit dans une intégration partagée connectée, ou lorsqu'un nouveau message de premier niveau est publié dans un canal Slack sélectionné. Disponible pour les automatisations personnalisées. Sélectionnez l'intégration et l'événement, puis remplissez les champs supplémentaires affichés. Pour les déclencheurs Slack, choisissez un ou plusieurs canaux auxquels l'[application Mintlify pour Slack](/fr/agent/slack) a été ajoutée. -- **Webhook** : s'exécute lorsqu'une requête `POST` authentifiée atteint le point de terminaison webhook de l'automatisation. Disponible uniquement pour les automatisations personnalisées. Enregistrez d'abord l'automatisation ; la carte du déclencheur affiche alors l'URL du webhook et une action **Copy auth header** pour l'en-tête `Authorization: Bearer `. Fournissez une clé d'API d'organisation non expirée avec accès en écriture depuis la page [API keys](https://app.mintlify.com/settings/organization/api-keys). Utilisez-le pour déclencher une exécution depuis un pipeline CI/CD, un script de publication ou un outil interne. Consultez [Déclencher un webhook d'automatisation](/fr/api/automations/webhook) pour le point de terminaison et les limites de débit. +- **Webhook** : s'exécute lorsqu'une requête `POST` authentifiée atteint le point de terminaison webhook de l'automatisation. Disponible uniquement pour les automatisations personnalisées. Enregistrez d'abord l'automatisation. La carte du déclencheur affiche alors l'URL du webhook et une action **Copy auth header** pour l'en-tête `Authorization: Bearer `. Fournissez une clé d'API d'organisation non expirée avec accès en écriture depuis la page [API keys](https://app.mintlify.com/settings/organization/api-keys). Utilisez-le pour déclencher une exécution depuis un pipeline CI/CD, un script de publication ou un outil interne. Consultez [Déclencher un webhook d'automatisation](/fr/api/automations/webhook) pour le point de terminaison et les limites de débit.
#### Filtrer les déclencheurs de modification de code diff --git a/fr/help-center/publish-button-disabled-invalid-mdx.mdx b/fr/help-center/publish-button-disabled-invalid-mdx.mdx index 29eddfe075..6cd4fe06ea 100644 --- a/fr/help-center/publish-button-disabled-invalid-mdx.mdx +++ b/fr/help-center/publish-button-disabled-invalid-mdx.mdx @@ -23,7 +23,7 @@ Tant qu'une page contient un MDX non valide ou un frontmatter YAML non valide, c Si l'infobulle indique une seule page en erreur, il s'agit généralement de celle que vous êtes en train de modifier. Si elle en indique plusieurs, ou si vous ne savez pas laquelle contient l'erreur, examinez chaque page que vous avez modifiée sur la branch : 1. Cliquez sur **Publish** dans la barre d'outils pour ouvrir le menu de publication. Le menu liste tous les fichiers modifiés sur votre branch. -2. Ouvrez tour à tour chaque fichier modifié et cherchez les erreurs de parsing en mode source (voir ci-dessous). Les pages qui parsent correctement s'affichent normalement ; la page en erreur affiche l'erreur. +2. Ouvrez tour à tour chaque fichier modifié et cherchez les erreurs de parsing en mode source (voir ci-dessous). Les pages qui parsent correctement s'affichent normalement. La page en erreur affiche l'erreur.
diff --git a/zh/automations/manage.mdx b/zh/automations/manage.mdx index 43b2804e90..aab2211e3e 100644 --- a/zh/automations/manage.mdx +++ b/zh/automations/manage.mdx @@ -50,7 +50,7 @@ import GitlabAutomationSetup from '/snippets/zh/gitlab-automation-setup.mdx'; - **代码变更(Code change)**:当已连接的源代码仓库中有 pull request 合并时运行。你必须至少指定一个源仓库。点击 **Add repo** 可让来自多个仓库的 pull request 触发该自动化。对于每个仓库,你可以选择设置 **Exclude author** 来忽略来自特定作者的 pull request,以及 **Listening to changes in** 仅在特定路径下有变更的 pull request 时触发。 - **自定义计划(Custom schedule)**:按你定义的周期性计划运行。选择一个预设(**Daily**、**Every Monday**、**Every Friday** 或 **Twice weekly**)以及起始小时,或选择 **Custom cron** 并输入标准的 5 段式 cron 表达式(`minute hour day month weekday`)。cron 值以 UTC 存储;控制台会在你的本地时区与预设小时之间进行转换。自动化会在预定时间的 10 分钟内进入队列。 - **集成(Integration)**:当已连接的共享集成中发生所选事件时运行,或当在所选 Slack 频道中发布新的顶层消息时运行。此选项适用于自定义自动化。请选择集成和事件,并填写出现的任何其他事件字段。对于 Slack 触发器,请选择一个或多个已添加 [Mintlify Slack 应用](/zh/agent/slack)的频道。 -- **Webhook**:当一个已认证的 `POST` 请求命中自动化的 webhook 端点时运行。仅适用于自定义自动化。先保存自动化;触发器卡片随后会显示 webhook URL 和用于 `Authorization: Bearer ` 请求头的 **Copy auth header** 操作。在 [API keys](https://app.mintlify.com/settings/organization/api-keys) 页面提供一个具有写入权限且未过期的组织 API 密钥。可用于从 CI/CD 流水线、发布脚本或内部工具触发运行。有关端点和速率限制,请参见[触发自动化 webhook](/zh/api/automations/webhook)。 +- **Webhook**:当一个已认证的 `POST` 请求命中自动化的 webhook 端点时运行。仅适用于自定义自动化。先保存自动化。触发器卡片随后会显示 webhook URL 和用于 `Authorization: Bearer ` 请求头的 **Copy auth header** 操作。在 [API keys](https://app.mintlify.com/settings/organization/api-keys) 页面提供一个具有写入权限且未过期的组织 API 密钥。可用于从 CI/CD 流水线、发布脚本或内部工具触发运行。有关端点和速率限制,请参见[触发自动化 webhook](/zh/api/automations/webhook)。
#### 过滤代码变更触发器 diff --git a/zh/help-center/publish-button-disabled-invalid-mdx.mdx b/zh/help-center/publish-button-disabled-invalid-mdx.mdx index aa34ae65fb..d0935b51d0 100644 --- a/zh/help-center/publish-button-disabled-invalid-mdx.mdx +++ b/zh/help-center/publish-button-disabled-invalid-mdx.mdx @@ -23,7 +23,7 @@ keywords: ["publish disabled", "fix invalid MDX before publishing", "invalid MDX 如果提示只显示一个损坏的页面,通常就是你当前正在编辑的那一个。如果显示多个,或者你不确定是哪个页面有错误,请检查你在分支上更改过的每个页面: 1. 点击工具栏中的 **Publish** 打开发布菜单。菜单会列出你分支上所有已更改的文件。 -2. 依次打开每个已更改的文件,并在 source 模式下查找解析错误(见下文)。能够正常解析的页面会正常显示;出错的页面会显示错误。 +2. 依次打开每个已更改的文件,并在 source 模式下查找解析错误(见下文)。能够正常解析的页面会正常显示。出错的页面会显示错误。
From b441214d17526862d296d67031b3889ea5501f2d Mon Sep 17 00:00:00 2001 From: Ethan Palm <56270045+ethanpalm@users.noreply.github.com> Date: Thu, 24 Sep 2026 08:47:37 -0700 Subject: [PATCH 3/3] Apply suggestion from @ethanpalm --- .../agent-opens-pull-requests-against-deploy-branch.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/help-center/agent-opens-pull-requests-against-deploy-branch.mdx b/help-center/agent-opens-pull-requests-against-deploy-branch.mdx index a672699bce..c05f52e9d4 100644 --- a/help-center/agent-opens-pull-requests-against-deploy-branch.mdx +++ b/help-center/agent-opens-pull-requests-against-deploy-branch.mdx @@ -25,5 +25,5 @@ To stop automation PRs from merging without review, set the automation's update ## Related settings -- [Choose how the agent publishes changes](/agent/index#choose-how-the-agent-publishes-changes)—pull request vs. direct push, and how branch protection interacts with each. -- [Git Settings](https://app.mintlify.com/settings/project/git-settings)—change the deploy branch or the docs subdirectory the deployment builds from. +- [Choose how the agent publishes changes](/agent/index#choose-how-the-agent-publishes-changes): Pull request versus direct push, and how branch protection interacts with each. +- [Git Settings](https://app.mintlify.com/settings/project/git-settings): Change the deploy branch or the docs subdirectory the deployment builds from.