@@ -30,6 +30,10 @@ Estas prácticas básicas de SEO técnico ayudan a que tu documentación sea má
* **Texto alternativo para imágenes:** Incluye texto alternativo descriptivo en las imágenes con palabras clave relevantes. Por ejemplo, “flujo de autenticación de API con OAuth 2.0” en lugar de solo “diagrama”. Esto mejora el SEO y la accesibilidad.
* **Sitemaps:** Asegúrate de que tu sitemap esté actualizado. Mintlify genera automáticamente un sitemap. No obstante, puedes crear uno manualmente si prefieres un formato personalizado. Una vez creado, los motores de búsqueda lo indexan con el tiempo, pero puedes enviar tu sitemap directamente a Google Search Console para acelerar el proceso.
+
+ Usa un [flujo de trabajo](/es/agent/workflows) para ejecutar una auditoría SEO semanal que verifique metadata faltante o débil y abra una solicitud de extracción con mejoras.
+
+
## Rendimiento de la página
diff --git a/es/guides/style-and-tone.mdx b/es/guides/style-and-tone.mdx
index 3cbba72d9..04fe8b69d 100644
--- a/es/guides/style-and-tone.mdx
+++ b/es/guides/style-and-tone.mdx
@@ -39,6 +39,10 @@ Aprovecha guías de estilo existentes para estandarizar tu documentación:
Cuando tengas claros los principios de redacción que quieres implementar, automatiza todo lo que puedas. Puedes usar [verificaciones de CI](/es/deploy/ci) o linters como [Vale](https://vale.sh).
+
+ Usa un [flujo de trabajo](/es/agent/workflows) para ejecutar una auditoría de estilo de forma programada o cada vez que se envíen cambios a tu repositorio de documentación, corrigiendo automáticamente las infracciones y marcando aquello que requiera revisión adicional.
+
+
## Páginas relacionadas
diff --git a/fr/guides/maintenance.mdx b/fr/guides/maintenance.mdx
index a1f5d2522..337da1ccf 100644
--- a/fr/guides/maintenance.mdx
+++ b/fr/guides/maintenance.mdx
@@ -18,6 +18,10 @@ Introduisez des automatisations lorsque c’est possible, par exemple :
* **Automatisez les mises à jour de la documentation :** Mettez en place un workflow pour actualiser automatiquement la documentation lorsque du code est fusionné avec l’[agent API](/fr/guides/automate-agent).
* **Faites respecter les normes avec des linters :** Utilisez [Vale](http://Vale.sh) ou des [vérifications CI](/fr/deploy/ci) pour détecter automatiquement les problèmes de formatage, les écarts de style rédactionnel ou les metadata manquantes dans chaque pull request (demande de fusion).
+
+ Utilisez des [workflows](/fr/agent/workflows) pour automatiser les tâches de maintenance récurrentes comme l'application des guides de style, la vérification des metadata ou la rédaction de changelogs.
+
+
## Mettre en place un processus de relecture
diff --git a/fr/guides/seo.mdx b/fr/guides/seo.mdx
index 554b4b2ae..b529c2c96 100644
--- a/fr/guides/seo.mdx
+++ b/fr/guides/seo.mdx
@@ -5,18 +5,18 @@ keywords: ["search engine optimization", "meta tags", "keyword research"]
---
-Cette page explique des stratégies essentielles pour optimiser le SEO de votre documentation.
+ Cette page explique des stratégies essentielles pour optimiser le SEO de votre documentation.
## Principes de base du contenu
-Facilitez l’exploration de votre contenu et de sa structure par les moteurs de recherche.
+Facilitez l'exploration de votre contenu et de sa structure par les moteurs de recherche.
* **Titres et sous-titres :** Utilisez des en-têtes séquentiels et explicites pour structurer votre contenu. Chaque page comporte un H1 généré à partir de la propriété `title:` dans le frontmatter.
-* **Paragraphes courts et listes :** Divisez les blocs de texte volumineux en sections faciles à lire. Utilisez des listes à puces et des listes numérotées lorsque c’est pertinent.
-* **Liens internes :** Créez des liens vers du contenu connexe en utilisant un texte d’ancrage descriptif. Par exemple, « En savoir plus sur la limitation de débit » plutôt que « Cliquez ici ».
+* **Paragraphes courts et listes :** Divisez les blocs de texte volumineux en sections faciles à lire. Utilisez des listes à puces et des listes numérotées lorsque c'est pertinent.
+* **Liens internes :** Créez des liens vers du contenu connexe en utilisant un texte d'ancrage descriptif. Par exemple, « En savoir plus sur la limitation de débit » plutôt que « Cliquez ici ».
## Principes de base du SEO technique
@@ -27,19 +27,23 @@ Une fois votre contenu optimisé, assurez-vous que votre documentation fonctionn
Ces pratiques fondamentales en SEO technique rendent votre documentation plus facilement découvrable :
* **Balises meta et descriptions :** Rédigez des titres optimisés pour le SEO (50–60 caractères) et des descriptions (150–160 caractères) pour chaque page. La plupart des [balises meta](/fr/optimize/seo) sont générées automatiquement.
-* **Texte alternatif pour les images :** Fournissez un texte alternatif descriptif pour les images, intégrant des mots-clés pertinents. Par exemple, « Flux d’authentification OAuth 2.0 d’une API » plutôt que simplement « diagramme ». Cela améliore le SEO et l’accessibilité.
-* **Sitemaps :** Assurez-vous que votre sitemap est à jour. Mintlify génère automatiquement un sitemap. Vous pouvez toutefois créer manuellement un sitemap si vous préférez un format personnalisé. Une fois créé, les moteurs de recherche l’indexent au fil du temps, mais vous pouvez soumettre votre sitemap directement dans la Google Search Console pour accélérer le processus.
+* **Texte alternatif pour les images :** Fournissez un texte alternatif descriptif pour les images, intégrant des mots-clés pertinents. Par exemple, « Flux d'authentification OAuth 2.0 d'une API » plutôt que simplement « diagramme ». Cela améliore le SEO et l'accessibilité.
+* **Sitemaps :** Assurez-vous que votre sitemap est à jour. Mintlify génère automatiquement un sitemap. Vous pouvez toutefois créer manuellement un sitemap si vous préférez un format personnalisé. Une fois créé, les moteurs de recherche l'indexent au fil du temps, mais vous pouvez soumettre votre sitemap directement dans la Google Search Console pour accélérer le processus.
+
+
+ Utilisez un [workflow](/fr/agent/workflows) pour lancer un audit SEO hebdomadaire qui vérifie les metadata manquantes ou faibles et ouvre une pull request avec des améliorations.
+
## Performance des pages
-Utilisez des outils comme [Google PageSpeed Insights](https://pagespeed.web.dev) pour identifier les axes d’amélioration technique en SEO (Search Engine Optimization).
+Utilisez des outils comme [Google PageSpeed Insights](https://pagespeed.web.dev) pour identifier les axes d'amélioration technique en SEO (Search Engine Optimization).
-Exemples d’optimisations plus avancées :
+Exemples d'optimisations plus avancées :
-* **Optimiser les médias pour la vitesse :** Compressez les images avec des formats comme WebP ou AVIF et veillez à ce que vos pages se chargent rapidement (idéalement en moins de 3 secondes).
-* **Données structurées (balisage de schéma) :** Ajoutez du balisage de schéma (comme HowTo, FAQ) à vos pages pour aider les moteurs de recherche à mieux comprendre et classer votre contenu.
+* **Optimiser les médias pour la vitesse :** Compressez les images avec des formats comme WebP ou AVIF et veillez à ce que vos pages se chargent rapidement (idéalement en moins de 3 secondes).
+* **Données structurées (balisage de schéma) :** Ajoutez du balisage de schéma (comme HowTo, FAQ) à vos pages pour aider les moteurs de recherche à mieux comprendre et classer votre contenu.
## Recherche de mots-clés
@@ -48,4 +52,4 @@ Exemples d’optimisations plus avancées :
Pour augmenter le trafic organique, prenez le temps de comprendre quels mots-clés aident les utilisateurs à trouver votre documentation.
* **Recherche de mots-clés :** Utilisez des outils gratuits comme [Google Keyword Planner](https://ads.google.com/intl/en_us/home/tools/keyword-planner/) ou [Keywords Everywhere](https://keywordseverywhere.com) pour identifier des expressions courantes ou des mots-clés de longue traîne.
-* **Intégrez les mots-clés naturellement :** Ajoutez des mots-clés de manière naturelle dans les titres, sous-titres et dans le corps du texte. N’abusez pas des mots-clés. Votre documentation doit être rédigée pour vos utilisateurs, pas pour les moteurs de recherche.
\ No newline at end of file
+* **Intégrez les mots-clés naturellement :** Ajoutez des mots-clés de manière naturelle dans les titres, sous-titres et dans le corps du texte. N'abusez pas des mots-clés. Votre documentation doit être rédigée pour vos utilisateurs, pas pour les moteurs de recherche.
diff --git a/fr/guides/style-and-tone.mdx b/fr/guides/style-and-tone.mdx
index 17c4eeed7..556dc9393 100644
--- a/fr/guides/style-and-tone.mdx
+++ b/fr/guides/style-and-tone.mdx
@@ -39,6 +39,10 @@ Appuyez-vous sur des guides de style existants pour standardiser votre documenta
Une fois les principes rédactionnels à adopter définis, automatisez au maximum. Vous pouvez utiliser des [contrôles CI](/fr/deploy/ci) ou des analyseurs comme [Vale](https://vale.sh).
+
+ Utilisez un [workflow](/fr/agent/workflows) pour lancer un audit de style de manière planifiée ou à chaque fois que des modifications sont poussées vers votre dépôt de documentation, afin de corriger automatiquement les violations et de signaler ce qui nécessite une révision supplémentaire.
+
+
## Pages connexes
diff --git a/zh/guides/maintenance.mdx b/zh/guides/maintenance.mdx
index c466d7a36..284099fc0 100644
--- a/zh/guides/maintenance.mdx
+++ b/zh/guides/maintenance.mdx
@@ -16,7 +16,11 @@ keywords: ["maintenance", "content lifecycle", "stale content"]
* **跟踪过时内容：** 运行脚本标记过去三个月未更新的重要文档。它们是否仍然准确？
* **自动更新文档：** 构建工作流，当代码合并时，通过 [agent API](/zh/guides/automate-agent) 自动更新文档。
-* **用 linter 强制执行标准：** 使用 [Vale](http://Vale.sh) 或 [CI 检查](/zh/deploy/ci)，在每个拉取请求（PR；亦称“合并请求”/Merge Request）中自动捕获格式问题、写作风格偏差或缺失的 metadata。
+* **用 linter 强制执行标准：** 使用 [Vale](http://Vale.sh) 或 [CI 检查](/zh/deploy/ci)，在每个拉取请求（PR；亦称"合并请求"/Merge Request）中自动捕获格式问题、写作风格偏差或缺失的 metadata。
+
+
+ 使用[工作流](/zh/agent/workflows)来自动化周期性维护任务，例如执行风格指南、检查 metadata 或起草变更日志。
+
## 建立评审流程
@@ -27,7 +31,7 @@ keywords: ["maintenance", "content lifecycle", "stale content"]
在效率与质量之间取得平衡：
* **聚焦高影响力文档。** 并非每个页面都需要定期更新。务必定期审查最重要的页面，确保其准确且具备时效性。
-* **善用社区力量。** 如果你的文档是开源的，赋予用户通过拉取请求（PR；亦称“合并请求”/Merge Request）标记问题或提交修复的能力。这有助于建立信任并保持内容新鲜。
+* **善用社区力量。** 如果你的文档是开源的，赋予用户通过拉取请求（PR；亦称"合并请求"/Merge Request）标记问题或提交修复的能力。这有助于建立信任并保持内容新鲜。
## 何时该重写
@@ -43,4 +47,4 @@ keywords: ["maintenance", "content lifecycle", "stale content"]
## 错误的文档可能比没有文档更糟
-过时或带有误导性的文档会浪费用户时间并侵蚀信任。如果某个页面完全不准确且短期内无法修复，通常最好直接移除。与错误的信息相比，用户更希望看到更少但正确的信息。
\ No newline at end of file
+过时或带有误导性的文档会浪费用户时间并侵蚀信任。如果某个页面完全不准确且短期内无法修复，通常最好直接移除。与错误的信息相比，用户更希望看到更少但正确的信息。
diff --git a/zh/guides/seo.mdx b/zh/guides/seo.mdx
index 6b1384d62..95605f95d 100644
--- a/zh/guides/seo.mdx
+++ b/zh/guides/seo.mdx
@@ -5,7 +5,7 @@ keywords: ["search engine optimization", "meta tags", "keyword research"]
---
-本页介绍优化文档 SEO 的基础策略。
+ 本页介绍优化文档 SEO 的基础策略。
@@ -30,6 +30,10 @@ keywords: ["search engine optimization", "meta tags", "keyword research"]
* **图片 Alt 文本：** 为图片提供包含相关关键词的描述性 alt 文本。例如，用 “OAuth 2.0 API 认证流程” 而不是仅写 “diagram”。这有助于提升 SEO 和可访问性。
* **站点地图（Sitemaps）：** 确保站点地图为最新。Mintlify 会自动生成站点地图；如需自定义格式，也可手动创建。创建后，搜索引擎会随着时间索引站点地图，但你也可以将其直接提交到 Google Search Console 以加快收录。
+
+ 使用[工作流](/zh/agent/workflows)执行每周 SEO 审计，检查缺失或薄弱的 metadata，并提交包含改进的拉取请求。
+
+
## 页面性能
diff --git a/zh/guides/style-and-tone.mdx b/zh/guides/style-and-tone.mdx
index 9b6343ce0..6a479e44d 100644
--- a/zh/guides/style-and-tone.mdx
+++ b/zh/guides/style-and-tone.mdx
@@ -39,6 +39,10 @@ keywords: ["写作原则", "主动语态", "技术写作", "风格指南"]
当你明确要采纳哪些写作原则后，尽可能将其自动化。你可以使用 [CI checks](/zh/deploy/ci) 或像 [Vale](https://vale.sh) 这样的 linter。
+
+ 使用[工作流](/zh/agent/workflows)按计划运行风格审计，或在每次向文档仓库推送更改时自动修复违规问题，并标记需要进一步审查的内容。
+
+
## 相关页面