mintlify · mintlify · Mar 21, 2026 · Mar 21, 2026
diff --git a/docs.json b/docs.json
@@ -463,6 +463,7 @@
                     "pages": [
                       "fr/agent/index",
                       "fr/agent/slack",
+                      "fr/agent/linear",
                       "fr/agent/customize",
                       "fr/agent/effective-prompts",
                       "fr/agent/workflows"
@@ -830,6 +831,7 @@
                     "pages": [
                       "es/agent/index",
                       "es/agent/slack",
+                      "es/agent/linear",
                       "es/agent/customize",
                       "es/agent/effective-prompts",
                       "es/agent/workflows"
@@ -1197,6 +1199,7 @@
                     "pages": [
                       "zh/agent/index",
                       "zh/agent/slack",
+                      "zh/agent/linear",
                       "zh/agent/customize",
                       "zh/agent/effective-prompts",
                       "zh/agent/workflows"

diff --git a/es/agent/index.mdx b/es/agent/index.mdx
@@ -24,7 +24,7 @@ Todos los cambios pasan por solicitudes de extracción (pull requests). El agent
 
 Usa el agente para:
 
-* Escribir contenido nuevo basado en tus prompts, solicitudes de extracción, hilos de Slack o archivos adjuntos.
+* Escribir contenido nuevo basado en tus prompts, solicitudes de extracción, issues de Linear, hilos de Slack o archivos adjuntos.
 * Actualizar documentación existente con nuevas funcionalidades o cambios en la API.
 * Procesar e incluir imágenes, diagramas y otros archivos a partir de archivos adjuntos de Slack.
 * Buscar y revisar ejemplos de código y referencias de API en toda tu documentación.
@@ -53,6 +53,9 @@ El agente solo puede acceder a los repositorios que conectes mediante la Aplicac
 <Card title="Conectar Slack" horizontal icon="slack" href="/es/agent/slack">
   Añade el agente a tu espacio de trabajo de Slack.
 </Card>
+<Card title="Conectar Linear" horizontal icon="linear" href="/es/agent/linear">
+  Añade el agente a tu espacio de trabajo de Linear.
+</Card>
 
 <Card title="Personalizar comportamiento" horizontal icon="wrench" href="/es/agent/customize">
   Configura el agente con un archivo `AGENTS.md`.

diff --git a/es/agent/linear.mdx b/es/agent/linear.mdx
@@ -0,0 +1,40 @@
+---
+title: "Añade el agente a Linear"
+description: "Usa el agente en Linear para crear actualizaciones de documentación a partir de issues y comentarios."
+keywords: ["issue tracking", "project management"]
+---
+
+Conecta tu espacio de trabajo de Linear al agente para realizar actualizaciones de documentación desde Linear. Cuando mencionas al agente de Mintlify en un comentario de Linear o le asignas un issue, el agente recopila contexto del issue y abre una solicitud de extracción con los cambios propuestos en tu documentación.
+
+<div id="connect-your-linear-workspace">
+  ## Conecta tu espacio de trabajo de Linear
+</div>
+
+1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
+2. En la sección "Agent settings", haz clic en **Install Linear app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="hidden dark:block" />
+  </Frame>
+3. Sigue las indicaciones de Linear para autorizar la aplicación de Mintlify en tu espacio de trabajo.
+
+<div id="use-the-agent-in-linear">
+  ## Usar el agente en Linear
+</div>
+
+Una vez conectado, menciona `@mintlify` en un issue de Linear o asigna un issue a `Mintlify` para activar una actualización de documentación. El agente utiliza el título, la descripción y el hilo de comentarios del issue como contexto, y luego abre una solicitud de extracción en tu repositorio de documentación.
+
+Usa el agente en Linear para:
+
+- **Actualizar la documentación a partir de issues de funcionalidades**: Cuando se lanza una funcionalidad, menciona al agente en el issue para redactar o actualizar la documentación correspondiente.
+- **Actuar sobre comentarios de documentación**: Crea issues en Linear para mejoras de documentación y menciona al agente para que realice los cambios.
+- **Generar notas de versión**: Menciona al agente en un issue relacionado con un lanzamiento para redactar entradas de changelog basadas en los detalles del issue.
+- **Corregir problemas reportados**: Cuando alguien reporta un problema de documentación en Linear, menciona al agente para resolverlo.
+
+<div id="best-practices">
+  ## Mejores prácticas
+</div>
+
+- **Incluye contexto en el issue**: Cuanto más contexto proporciones en un issue, mejor será la solicitud de extracción resultante.
+- **Revisa las solicitudes de extracción**: Siempre revisa las solicitudes de extracción que crea el agente antes de fusionarlas.
+- **Itera en los comentarios**: Responde en el mismo hilo del issue para refinar el resultado del agente, de forma similar a como lo harías en Slack.
diff --git a/es/agent/slack.mdx b/es/agent/slack.mdx
@@ -12,18 +12,17 @@ keywords: ["Integración con Slack", "Bot de Slack", "Colaboración en equipo",
   ## Conecta tu espacio de trabajo de Slack
 </div>
 
-1. Abre el panel del agente en tu dashboard.
-2. Haz clic en el botón **Settings**.
-    <Frame>
-    <img src="/images/agent/dashboard-settings-light.png" alt="El botón de configuración en modo claro." className="block dark:hidden" />
-    <img src="/images/agent/dashboard-settings-dark.png" alt="El botón de configuración en modo oscuro." className="hidden dark:block" />
-    </Frame>
-3. En la sección de integración con Slack, haz clic en **Connect**.
-4. Sigue las indicaciones de Slack para agregar la app `mintlify` a tu espacio de trabajo.
-5. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.
-6. Verifica que el agente esté funcionando y responda cuando:
-   - Le envíes un mensaje directo.
-   - Lo menciones con `@mintlify` en un canal.
+1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
+2. En la sección "Agent settings", haz clic en **Install Slack app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La sección de configuración de aplicaciones con los botones de instalación de Slack y Linear." className="hidden dark:block" />
+  </Frame>
+3. Sigue las indicaciones de Slack para instalar la app `mintlify` en tu espacio de trabajo.
+4. Sigue las indicaciones de Slack para vincular tu cuenta de Mintlify con tu espacio de trabajo de Slack.
+5. Verifica que el agente esté funcionando y responda cuando:
+   - Le envíes un mensaje directo al agente.
+   - Menciones al agente con `@mintlify` en un canal.
 
 <div id="use-the-agent-in-slack">
   ## Usar el agente en Slack

diff --git a/es/guides/automate-agent.mdx b/es/guides/automate-agent.mdx
@@ -48,23 +48,10 @@ Este tutorial asume que tu documentación está en un repositorio separado del c
 
     La aplicación de Mintlify debe estar instalada en tu repositorio de código para que el agente pueda obtener el contexto de tu código base. Para agregar la aplicación a repositorios nuevos:
 
-    1. Abre el panel del agente en tu Dashboard de Mintlify.
-
-       <Frame>
-         <img src="/images/agent/dashboard-light.png" alt="El panel del agente en modo claro." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-dark.png" alt="El panel del agente en modo oscuro." className="hidden dark:block" />
-       </Frame>
-    2. Haz clic en el botón **Settings**.
-
-       <Frame>
-         <img src="/images/agent/dashboard-settings-light.png" alt="El botón de configuración en modo claro." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-settings-dark.png" alt="El botón de configuración en modo oscuro." className="hidden dark:block" />
-       </Frame>
-    3. Haz clic en **Add to New Organization**. Esto te llevará a la página de instalación de la aplicación en GitHub.
-    4. Selecciona en la lista los repositorios a los que quieres otorgar acceso.
-    5. Guarda tus cambios.
+    1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
+    1. Haz clic en **Add to New Organization**. Esto te llevará a la página de instalación de la aplicación en GitHub.
+    1. Selecciona en la lista los repositorios a los que quieres otorgar acceso.
+    1. Guarda tus cambios.
 
     ### Obtén tu clave de API de administrador
 
@@ -222,23 +209,10 @@ Este tutorial asume que tu documentación está en un repositorio separado del c
 
     La aplicación de Mintlify debe estar instalada en tu repositorio de código para que el agente pueda obtener el contexto de tu código base. Para agregar la aplicación a repositorios nuevos:
 
-    1. Abre el panel del agente en tu Dashboard de Mintlify.
-
-       <Frame>
-         <img src="/images/agent/dashboard-light.png" alt="El panel del agente en modo claro." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-dark.png" alt="El panel del agente en modo oscuro." className="hidden dark:block" />
-       </Frame>
-    2. Haz clic en el botón **Settings**.
-
-       <Frame>
-         <img src="/images/agent/dashboard-settings-light.png" alt="El botón de configuración en modo claro." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-settings-dark.png" alt="El botón de configuración en modo oscuro." className="hidden dark:block" />
-       </Frame>
-    3. Haz clic en **Add to New Organization**. Irás a la página de instalación de la aplicación en GitHub.
-    4. Selecciona en la lista los repositorios a los que deseas conceder acceso.
-    5. Guarda los cambios.
+    1. Ve a la página de [Agent](https://dashboard.mintlify.com/products/agent) en tu dashboard.
+    1. Haz clic en **Add to New Organization**. Irás a la página de instalación de la aplicación en GitHub.
+    1. Selecciona en la lista los repositorios a los que deseas conceder acceso.
+    1. Guarda los cambios.
 
     ### Obtén tu clave de API de administrador
 

diff --git a/fr/agent/index.mdx b/fr/agent/index.mdx
@@ -24,7 +24,7 @@ Tous les changements passent par des pull requests (demandes de fusion). L'agent
 
 Utilisez l’agent pour :
 
-* Rédiger de nouveaux contenus à partir de vos prompts, pull requests (demandes de fusion), fils Slack ou pièces jointes.
+* Rédiger de nouveaux contenus à partir de vos prompts, pull requests (demandes de fusion), issues Linear, fils Slack ou pièces jointes.
 * Mettre à jour la documentation existante pour de nouvelles fonctionnalités ou des évolutions d’API.
 * Traiter et intégrer des images, des schémas et d’autres fichiers à partir des pièces jointes Slack.
 * Rechercher et réviser des exemples de code et des références d’API dans l’ensemble de votre documentation.
@@ -53,6 +53,9 @@ L’agent ne peut accéder qu’aux dépôts que vous connectez via la GitHub Ap
 <Card title="Connecter Slack" horizontal icon="slack" href="/fr/agent/slack">
   Ajoutez l'agent à votre espace de travail Slack.
 </Card>
+<Card title="Connecter Linear" horizontal icon="linear" href="/fr/agent/linear">
+  Ajoutez l'agent à votre espace de travail Linear.
+</Card>
 
 <Card title="Personnaliser le comportement" horizontal icon="wrench" href="/fr/agent/customize">
   Configurez l&#39;agent avec un fichier `AGENTS.md`.

diff --git a/fr/agent/linear.mdx b/fr/agent/linear.mdx
@@ -0,0 +1,40 @@
+---
+title: "Ajouter l'agent à Linear"
+description: "Utilisez l'agent dans Linear pour créer des mises à jour de documentation à partir d'issues et de commentaires."
+keywords: ["issue tracking", "project management"]
+---
+
+Connectez votre espace de travail Linear à l'agent pour effectuer des mises à jour de documentation depuis Linear. Lorsque vous mentionnez l'agent Mintlify dans un commentaire Linear ou que vous lui assignez une issue, l'agent récupère le contexte de l'issue et ouvre une pull request (demande de fusion) avec les modifications proposées pour votre documentation.
+
+<div id="connect-your-linear-workspace">
+  ## Connectez votre espace de travail Linear
+</div>
+
+1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
+2. Dans la section "Agent settings", cliquez sur **Install Linear app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="hidden dark:block" />
+  </Frame>
+3. Suivez les instructions de Linear pour autoriser l'application Mintlify dans votre espace de travail.
+
+<div id="use-the-agent-in-linear">
+  ## Utiliser l'agent dans Linear
+</div>
+
+Une fois connecté, mentionnez `@mintlify` dans une issue Linear ou assignez une issue à `Mintlify` pour déclencher une mise à jour de la documentation. L'agent utilise le titre, la description et le fil de commentaires de l'issue comme contexte, puis ouvre une pull request (demande de fusion) dans votre référentiel de documentation.
+
+Utilisez l'agent dans Linear pour :
+
+- **Mettre à jour la documentation à partir d'issues de fonctionnalités** : Lorsqu'une fonctionnalité est livrée, mentionnez l'agent dans l'issue pour rédiger ou mettre à jour la documentation correspondante.
+- **Agir sur les retours de documentation** : Créez des issues Linear pour les améliorations de documentation et mentionnez l'agent pour effectuer les modifications.
+- **Générer des notes de version** : Mentionnez l'agent dans une issue liée à une release pour rédiger des entrées de changelog basées sur les détails de l'issue.
+- **Corriger les problèmes signalés** : Lorsque quelqu'un signale un problème de documentation dans Linear, mentionnez l'agent pour le résoudre.
+
+<div id="best-practices">
+  ## Bonnes pratiques
+</div>
+
+- **Incluez du contexte dans l'issue** : Plus vous fournissez de contexte dans une issue, meilleure sera la pull request (demande de fusion) résultante.
+- **Relisez les pull requests** : Relisez toujours les pull requests (demandes de fusion) créées par l'agent avant de les fusionner.
+- **Itérez dans les commentaires** : Répondez dans le même fil de l'issue pour affiner le résultat de l'agent, comme vous le feriez dans Slack.
diff --git a/fr/agent/slack.mdx b/fr/agent/slack.mdx
@@ -12,18 +12,17 @@ keywords: ["Intégration Slack", "Bot Slack", "Collaboration d'équipe", "Intég
   ## Connectez votre espace de travail Slack
 </div>
 
-1. Ouvrez le panneau de l'agent dans votre Dashboard.
-2. Cliquez sur le bouton **Settings**.
-    <Frame>
-    <img src="/images/agent/dashboard-settings-light.png" alt="Le bouton des paramètres en mode clair." className="block dark:hidden" />
-    <img src="/images/agent/dashboard-settings-dark.png" alt="Le bouton des paramètres en mode sombre." className="hidden dark:block" />
-    </Frame>
-3. Dans la section d'intégration à Slack, cliquez sur **Connect**.
-4. Suivez les instructions Slack pour ajouter l'application `mintlify` à votre espace de travail.
-5. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace de travail Slack.
-6. Vérifiez que l'agent fonctionne et répond lorsque vous :
-   - Lui envoyez un message direct.
-   - Le mentionnez avec `@mintlify` dans un canal.
+1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
+2. Dans la section "Agent settings", cliquez sur **Install Slack app**.
+  <Frame>
+    <img src="/images/agent/install-apps-light.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="block dark:hidden" />
+    <img src="/images/agent/install-apps-dark.png" alt="La section des paramètres d'application avec les boutons d'installation de Slack et Linear." className="hidden dark:block" />
+  </Frame>
+3. Suivez les instructions Slack pour installer l'application `mintlify` dans votre espace de travail.
+4. Suivez les instructions Slack pour lier votre compte Mintlify à votre espace de travail Slack.
+5. Vérifiez que l'agent fonctionne et répond lorsque vous :
+   - Envoyez un message direct à l'agent.
+   - Mentionnez l'agent avec `@mintlify` dans un canal.
 
 <div id="use-the-agent-in-slack">
   ## Utiliser l'agent dans Slack

diff --git a/fr/guides/automate-agent.mdx b/fr/guides/automate-agent.mdx
@@ -48,25 +48,12 @@ Ce tutoriel part du principe que votre documentation se trouve dans un référen
 
     L&#39;application Mintlify doit être installée sur votre référentiel de code pour que l&#39;agent puisse récupérer le contexte depuis votre base de code. Pour ajouter l&#39;application à de nouveaux référentiels :
 
-    1. Ouvrez le panneau Agent dans votre tableau de bord Mintlify.
+    1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
+    1. Cliquez sur **Add to New Organization**. Vous accéderez à la page d'installation de l'application sur GitHub.
+    1. Sélectionnez dans la liste les dépôts auxquels vous souhaitez accorder l'accès.
+    1. Enregistrez vos modifications.
 
-       <Frame>
-         <img src="/images/agent/dashboard-light.png" alt="Le panneau de l’agent en mode clair." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-dark.png" alt="Le panneau de l’agent en mode sombre." className="hidden dark:block" />
-       </Frame>
-    2. Cliquez sur le bouton **Paramètres**.
-
-       <Frame>
-         <img src="/images/agent/dashboard-settings-light.png" alt="Le bouton Paramètres en mode clair." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-settings-dark.png" alt="Le bouton Paramètres en mode sombre." className="hidden dark:block" />
-       </Frame>
-    3. Cliquez sur **Add to New Organization**. Vous accéderez à la page d&#39;installation de l&#39;application sur GitHub.
-    4. Sélectionnez dans la liste les dépôts auxquels vous souhaitez accorder l’accès.
-    5. Enregistrez vos modifications.
-
-    ### Obtenez votre clé API d&#39;administration
+    ### Obtenez votre clé API d'administration
 
     1. Accédez à la page [Clés API](https://dashboard.mintlify.com/settings/organization/api-keys) depuis votre tableau de bord.
     2. Sélectionnez **Créer une clé API administrateur**.
@@ -222,23 +209,10 @@ Ce tutoriel part du principe que votre documentation se trouve dans un référen
 
     L&#39;application Mintlify doit être installée sur votre référentiel de code pour que l&#39;agent puisse récupérer le contexte depuis votre base de code. Pour ajouter l&#39;application à de nouveaux référentiels :
 
-    1. Ouvrez le panneau Agent dans votre tableau de bord Mintlify.
-
-       <Frame>
-         <img src="/images/agent/dashboard-light.png" alt="Le panneau de l’agent en mode clair." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-dark.png" alt="Le panneau de l’agent en mode sombre." className="hidden dark:block" />
-       </Frame>
-    2. Cliquez sur le bouton **Paramètres**.
-
-       <Frame>
-         <img src="/images/agent/dashboard-settings-light.png" alt="Le bouton Paramètres en mode clair." className="block dark:hidden" />
-
-         <img src="/images/agent/dashboard-settings-dark.png" alt="Le bouton Paramètres en mode sombre." className="hidden dark:block" />
-       </Frame>
-    3. Cliquez sur **Add to New Organization**. Vous accéderez à la page d&#39;installation de l&#39;application sur GitHub.
-    4. Sélectionnez, dans la liste, les dépôts auxquels vous souhaitez accorder l’accès.
-    5. Enregistrez vos modifications.
+    1. Accédez à la page [Agent](https://dashboard.mintlify.com/products/agent) de votre Dashboard.
+    1. Cliquez sur **Add to New Organization**. Vous accéderez à la page d'installation de l'application sur GitHub.
+    1. Sélectionnez, dans la liste, les dépôts auxquels vous souhaitez accorder l'accès.
+    1. Enregistrez vos modifications.
 
     ### Obtenez votre clé API d&#39;administration