Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
51 changes: 24 additions & 27 deletions docs.json
Original file line number Diff line number Diff line change
Expand Up @@ -464,8 +464,7 @@
"group": "Analyses",
"pages": [
"fr/insights/overview",
"fr/insights/feedback",
"fr/insights/search"
"fr/insights/feedback"
]
},
"fr/optimize/seo",
Expand Down Expand Up @@ -541,20 +540,20 @@
"fr/guides/migrating-from-mdx"
]
},
{
"group": "Analyses",
"icon": "chart-line",
"pages": [
"fr/guides/improving-docs"
]
},
{
"group": "Git",
"icon": "git-merge",
"pages": [
"fr/guides/git-concepts",
"fr/guides/branches"
]
},
{
"group": "Analyses",
"icon": "chart-line",
"pages": [
"fr/guides/improving-docs"
]
}
]
},
Expand Down Expand Up @@ -763,8 +762,7 @@
"group": "Información detallada",
"pages": [
"es/insights/overview",
"es/insights/feedback",
"es/insights/search"
"es/insights/feedback"
]
},
"es/optimize/seo",
Expand Down Expand Up @@ -840,20 +838,20 @@
"es/guides/migrating-from-mdx"
]
},
{
"group": "Información detallada",
"icon": "chart-line",
"pages": [
"es/guides/improving-docs"
]
},
{
"group": "Git",
"icon": "git-merge",
"pages": [
"es/guides/git-concepts",
"es/guides/branches"
]
},
{
"group": "Información detallada",
"icon": "chart-line",
"pages": [
"es/guides/improving-docs"
]
}
]
},
Expand Down Expand Up @@ -1062,8 +1060,7 @@
"group": "洞察",
"pages": [
"zh/insights/overview",
"zh/insights/feedback",
"zh/insights/search"
"zh/insights/feedback"
]
},
"zh/optimize/seo",
Expand Down Expand Up @@ -1139,20 +1136,20 @@
"zh/guides/migrating-from-mdx"
]
},
{
"group": "洞察",
"icon": "chart-line",
"pages": [
"zh/guides/improving-docs"
]
},
{
"group": "Git",
"icon": "git-merge",
"pages": [
"zh/guides/git-concepts",
"zh/guides/branches"
]
},
{
"group": "洞察",
"icon": "chart-line",
"pages": [
"zh/guides/improving-docs"
]
}
]
},
Expand Down
29 changes: 6 additions & 23 deletions es/guides/improving-docs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,36 +5,19 @@ description: "Usa datos para mejorar tu documentación"

Mejora tu documentación con datos cuantitativos y cualitativos de tu página de insights.

<div id="cross-analytics-insights">
## Insights multiplataforma en Analytics
</div>

Combina información de múltiples fuentes de insights para obtener una visión integral de tu documentación.

<div id="correlate-traffic-and-satisfaction">
### Correlaciona tráfico y satisfacción
</div>

- **Mucho tráfico y bajas valoraciones**: Páginas populares con una mala experiencia de usuario. Prioriza mejorar estas páginas.
- **Poco tráfico y altas valoraciones**: Documentación que funciona bien, pero quizá no sea fácil de descubrir. Considera promocionar estas páginas.
- **Mucho tráfico y altas valoraciones**: Los éxitos de tu documentación. Revisa estas páginas para obtener ideas que mejoren el resto de tu contenido.

<div id="match-search-intent-with-content-performance">
### Alinea la intención de búsqueda con el rendimiento del contenido
## Correlaciona tráfico y satisfacción
</div>

- **Alto volumen de búsqueda y pocas visitas a la página**: Problemas de descubrimiento. Considera reubicar estas páginas o revisar su frontmatter.
- **Términos de búsqueda populares y resultados con baja confianza**: Oportunidad por brecha de contenido. Considera agregar más contenido o crear contenido nuevo sobre estos temas.
- **Búsquedas más populares y comentarios negativos en las páginas correspondientes**: Problemas de experiencia del usuario. Revisa las páginas para verificar si resuelven la necesidad del usuario que motivó la búsqueda.
- **Alto tráfico y bajas calificaciones de comentarios**: Páginas populares con una mala experiencia de usuario. Prioriza mejorar estas páginas.
- **Bajo tráfico y altas calificaciones de comentarios**: Documentación que funciona bien, pero podría no ser fácil de encontrar. Considera destacar estas páginas.
- **Alto tráfico y altas calificaciones de comentarios**: Los mayores éxitos de tu documentación. Revisa estas páginas para obtener ideas para mejorar el resto de tu contenido.

<div id="put-insights-into-action">
## Convierte los insights en acción
</div>

Utiliza estos patrones de insights cruzados para priorizar las mejoras de tu documentación:
Usa estos patrones para priorizar las mejoras de tu documentación:

- **Soluciona primero los problemas de mayor impacto**: Las páginas populares con malas valoraciones afectan a más usuarios.
- **Cubre las brechas de contenido verificadas**: Las búsquedas con baja confianza y alto volumen indican necesidades de los usuarios no cubiertas.
- **Responde al feedback de los usuarios**: El feedback contextual y sobre fragmentos de código puede señalar áreas específicas de mejora.
- **Alinea la búsqueda con el contenido**: Asegúrate de que tus temas más buscados tengan páginas completas y bien organizadas.
- **Supervisa las tendencias de búsqueda en alza sin páginas populares existentes**: Nuevas oportunidades de contenido.
- **Responde a los comentarios de los usuarios**: El feedback contextual y sobre fragmentos de código puede identificar áreas específicas de mejora.
28 changes: 0 additions & 28 deletions es/insights/search.mdx

This file was deleted.

33 changes: 8 additions & 25 deletions fr/guides/improving-docs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,36 +5,19 @@ description: "Utilisez des données pour améliorer votre documentation"

Améliorez votre documentation à partir de données quantitatives et qualitatives disponibles sur votre page d’insights.

<div id="cross-analytics-insights">
## Analyses croisées
</div>

Combinez des informations issues de plusieurs sources d’analyses pour obtenir une vue d’ensemble de votre documentation.

<div id="correlate-traffic-and-satisfaction">
### Mettre en relation trafic et satisfaction
</div>

- **Trafic élevé et faibles scores de feedback** : Pages populaires avec une expérience utilisateur médiocre. Donnez la priorité à l’amélioration de ces pages.
- **Faible trafic et scores de feedback élevés** : Une documentation efficace, mais peut-être peu découvrable. Envisagez de promouvoir ces pages.
- **Trafic élevé et scores de feedback élevés** : Les incontournables de votre documentation. Passez ces pages en revue pour trouver des idées afin d’améliorer le reste de votre contenu.

<div id="match-search-intent-with-content-performance">
### Alignez l’intention de recherche avec les performances du contenu
## Mettre en corrélation trafic et satisfaction
</div>

- **Volume de recherche élevé et faible nombre de vues** : Problèmes de découvrabilité. Envisagez de déplacer ces pages ou de revoir leur frontmatter.
- **Termes de recherche populaires et résultats peu fiables** : Opportunité de combler un écart de contenu. Envisagez d’ajouter davantage de contenu ou de créer de nouveaux contenus sur ces sujets.
- **Recherches les plus populaires et retours négatifs sur les pages correspondantes** : Problèmes d’expérience utilisateur. Passez en revue les pages pour vérifier qu’elles répondent bien au besoin recherché.
- **Trafic élevé et faibles notes de feedback** : Pages populaires avec une mauvaise expérience utilisateur. Priorisez l’amélioration de ces pages.
- **Faible trafic et notes de feedback élevées** : Documentation efficace, mais peut-être difficile à trouver. Envisagez de promouvoir ces pages.
- **Trafic élevé et notes de feedback élevées** : Les incontournables de votre documentation. Passez en revue ces pages pour trouver des idées afin d’améliorer le reste de votre documentation.

<div id="put-insights-into-action">
## Transformez les insights en action
## Transformez les insights en actions
</div>

Utilisez ces modèles d’insights croisés pour hiérarchiser vos améliorations de documentation :
Utilisez ces approches pour hiérarchiser les améliorations de votre documentation :

- **Corrigez d’abord les problèmes à fort impact** : les pages populaires avec de mauvais scores de retour affectent le plus d’utilisateurs.
- **Comblez les lacunes de contenu avérées** : des recherches à faible confiance mais à fort volume indiquent des besoins utilisateurs non satisfaits.
- **Répondez aux retours des utilisateurs** : des retours contextuels et sur des extraits de code peuvent identifier des zones spécifiques à améliorer.
- **Alignez la recherche et le contenu** : assurez-vous que vos sujets les plus recherchés disposent de pages complètes et bien organisées.
- **Surveillez les tendances de recherche en hausse sans pages populaires existantes** : de nouvelles opportunités de contenu.
- **Corrigez d’abord les problèmes à fort impact** : les pages populaires avec de faibles scores de feedback affectent le plus grand nombre d’utilisateurs.
- **Répondez aux retours des utilisateurs** : les commentaires contextuels et sur des extraits de code peuvent mettre en évidence des zones spécifiques à améliorer.
28 changes: 0 additions & 28 deletions fr/insights/search.mdx

This file was deleted.

33 changes: 8 additions & 25 deletions zh/guides/improving-docs.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -5,36 +5,19 @@ description: "用数据让文档更出色"

基于 insights 页面中的定量与定性数据优化你的文档。

<div id="cross-analytics-insights">
## 跨 Analytics 洞察
</div>

整合来自多个洞察来源的信息,全面了解你的文档状况。

<div id="correlate-traffic-and-satisfaction">
### 关联流量与满意度
</div>

- **高流量且反馈分数低**:页面很受欢迎,但用户体验欠佳。应优先优化这些页面。
- **低流量且反馈分数高**:文档表现良好,但可能不易被发现。考虑提升其曝光度。
- **高流量且反馈分数高**:你文档中的“王牌”。审阅这些页面,为改进其余内容获取灵感。

<div id="match-search-intent-with-content-performance">
### 将搜索意图与内容表现相匹配
## 关联流量与满意度
</div>

- **搜索量高但页面浏览量低**:可发现性问题。考虑调整这些页面的位置或检查其 frontmatter
- **热门搜索词但结果置信度低**:内容缺口的机会。考虑在这些主题上补充更多内容或新增内容
- **热门搜索词但匹配页面收到负面反馈**:用户体验问题。检查这些页面是否真正解决了用户搜索的需求
- **高流量且低反馈评分**:受欢迎但用户体验不佳的页面。应优先改进这些页面
- **低流量且高反馈评分**:效果良好但可能不易被发现的文档。考虑推广这些页面
- **高流量且高反馈评分**:你的文档“王牌内容”。审阅这些页面,以获取改进其余对象的思路

<div id="put-insights-into-action">
## 将洞察付诸实践
## 将洞察付诸行动
</div>

使用以下跨洞察模式来优先推进文档改进
使用以下模式来优先推进文档改进

- **优先修复高影响问题**:热门页面若反馈评分偏低,将影响最多用户。
- **填补已验证的内容缺口**:高搜索量但低置信度的搜索表明用户需求尚未满足。
- **响应用户反馈**:基于上下文和代码片段的反馈可定位具体改进点。
- **对齐搜索与内容**:确保搜索最频繁的主题拥有全面、结构清晰的页面。
- **监测尚无对应热门页面的上升搜索趋势**:把握新的内容机会。
- **先修复高影响问题**:访问量高但反馈评分较低的页面对用户影响最大。
- **及时回应用户反馈**:基于上下文与代码片段的反馈可定位具体改进点。
28 changes: 0 additions & 28 deletions zh/insights/search.mdx

This file was deleted.