Files
mintlify__docs/es/guides/improving-docs.mdx
2026-01-27 11:59:01 -08:00

83 lines
4.8 KiB
Plaintext

---
title: "Mejora tu documentación"
description: "Usa datos y métricas para mejorar tu documentación."
keywords: ["metrics", "analytics", "bounce rate", "user satisfaction"]
---
<Tip>
Esta página explica cómo medir el éxito de tu documentación mediante métricas cuantitativas, comentarios cualitativos y su alineación con los objetivos empresariales.
</Tip>
<div id="quantitative-metrics">
## Métricas cuantitativas
</div>
Algunos ejemplos a considerar:
* **Vistas de página**: Las vistas pueden ser un buen indicador del éxito, pero podrían estar impulsadas por tráfico de bots o visitantes recurrentes. Si recibes muchas vistas en una página de errores o una página explicativa, podría indicar un problema con tu producto en general.
* **Tiempo en la página**: Un mayor tiempo en la página podría indicar interés, pero también podría significar que los usuarios están atascados intentando encontrar la información que necesitan.
* **Tasa de rebote**: Una tasa de rebote alta podría significar que los usuarios no encontraron lo que necesitaban, o podría significar que encontraron exactamente lo que buscaban y se fueron satisfechos.
La clave es comparar estas métricas a lo largo del tiempo o contra una línea base para detectar tendencias y entender si se alinean con que los usuarios logren sus objetivos.
<div id="correlate-traffic-and-satisfaction">
### Correlaciona tráfico y satisfacción
</div>
Usa Analytics para identificar patrones:
* **Alto tráfico y bajas valoraciones de feedback**: Páginas populares con una mala experiencia de usuario. Prioriza mejorar estas páginas.
* **Bajo tráfico y altas valoraciones de feedback**: Documentación que funciona bien, pero quizá no sea fácil de descubrir. Considera promocionar estas páginas.
* **Alto tráfico y altas valoraciones de feedback**: Los mayores aciertos de tu documentación. Revisa estas páginas para inspirarte y mejorar el resto de tu contenido.
<div id="qualitative-feedback">
## Comentarios cualitativos
</div>
Añade contexto a tus métricas cuantitativas con información cualitativa:
* **Comentarios de usuarios**: Usa [feedback](/es/optimize/feedback) para captar la opinión de los usuarios mediante calificaciones y comentarios abiertos, lo que te ayudará a entender qué funciona y dónde encuentran dificultades.
* **Aportes de stakeholders**: Obtén feedback periódico de equipos como soporte, ingeniería y éxito del cliente para identificar problemas comunes que enfrentan los usuarios y áreas de mejora.
* **Pruebas con usuarios**: Realiza pruebas de usabilidad para validar si los usuarios pueden encontrar las respuestas que necesitan y si tu documentación está alineada con sus expectativas. Consulta [Comprende a tu audiencia](/es/guides/understand-your-audience) para más información sobre investigación de usuarios.
<div id="business-alignment">
## Alineación con el negocio
</div>
Evalúa la documentación en relación con los objetivos empresariales más amplios:
* **Eficiencia del soporte**: Mide si tu documentación reduce el volumen de tickets de soporte o mejora las puntuaciones de satisfacción, lo que indicaría que está cubriendo las necesidades de los usuarios.
* **Onboarding y adopción**: Supervisa qué tan bien la documentación ayuda a los nuevos usuarios a ponerse al día, contribuyendo a una adopción del producto más rápida.
* **Retención**: Una documentación bien mantenida y fácil de seguir contribuye a experiencias positivas para los usuarios, ayudando a reducir la rotación y mejorar las tasas de retención.
<div id="put-analytics-into-action">
## Convierte Analytics en acciones
</div>
Utiliza estos patrones para priorizar las mejoras de tu documentación:
* **Soluciona primero los problemas de mayor impacto**: Las páginas populares con malas puntuaciones de feedback afectan a más usuarios.
* **Responde al feedback de los usuarios**: El feedback contextual y sobre fragmentos de código puede identificar áreas específicas de mejora.
* **Concéntrate en los recorridos clave de los usuarios**: Prioriza las páginas relacionadas con las tareas más importantes de tu producto.
<div id="related-pages">
## Páginas relacionadas
</div>
<CardGroup cols={2}>
<Card title="Descripción general de Analytics" icon="chart-line" href="/es/optimize/analytics">
Consulta Analytics y realiza un seguimiento del rendimiento de tu documentación.
</Card>
<Card title="Comentarios" icon="message-square" href="/es/optimize/feedback">
Recopila y analiza los comentarios de los usuarios sobre tu documentación.
</Card>
<Card title="Comprende a tu audiencia" icon="users" href="/es/guides/understand-your-audience">
Investiga y define el público de tu documentación.
</Card>
<Card title="SEO" icon="search" href="/es/optimize/seo">
Optimiza tu documentación para los motores de búsqueda.
</Card>
</CardGroup>