Saltar al contenido principal
Una buena documentación nunca está terminada. Los productos cambian, las necesidades de los usuarios evolucionan y el contenido que funcionaba hace seis meses puede que ya no refleje cómo se comporta el producto. Medir la documentación de forma sistemática te ayuda a enfocar los esfuerzos de mejora donde tendrán mayor impacto, en lugar de adivinar. Esta guía cubre cómo usar métricas cuantitativas, comentarios cualitativos y señales de negocio para encontrar y corregir las páginas que más importan.

​
Usa métricas cuantitativas

Las analíticas te ofrecen una visión amplia del rendimiento de la documentación. Las métricas más útiles son señales, no respuestas: te indican dónde mirar, no exactamente qué corregir.

​
Vistas de página y tráfico

Las páginas con más tráfico son tu inversión más importante en documentación. Los problemas en una página con 10,000 vistas mensuales afectan a muchos más usuarios que los mismos problemas en una página con 200 vistas. Presta atención a:
  • Tráfico inesperadamente alto en páginas de errores o solución de problemas. Los usuarios no deberían necesitar leer sobre errores constantemente. Un tráfico alto en estas páginas suele indicar un problema de UX del producto que vale la pena reportar a tu equipo.
  • Bajo tráfico en páginas que esperas que sean populares. Si una página clave de inicio rápido tiene pocas vistas, es posible que los usuarios no la encuentren; revisa tu navegación y enlaces internos.

​
Tiempo en la página

Un tiempo largo en la página puede significar interés o confusión. Un tiempo corto puede significar que los usuarios encontraron lo que necesitaban de inmediato o que se rindieron y se fueron. Interpreta el tiempo en la página según el contexto:
  • Las páginas de referencia extensas deberían tener un tiempo promedio más corto: los usuarios están escaneando
  • El contenido de tutoriales debería tener un tiempo más largo: los usuarios están siguiendo los pasos
  • Si una página sencilla de instrucciones tiene un tiempo inusualmente alto, es posible que los usuarios estén teniendo dificultades para completar la tarea

​
Tasa de rebote

La tasa de rebote mide a los usuarios que visitan una página y se van sin navegar más. Una tasa de rebote alta no es inherentemente mala: los usuarios que encuentran exactamente lo que necesitan y regresan a su trabajo representan una interacción exitosa. Combina la tasa de rebote con las puntuaciones de comentarios para interpretarla correctamente. Una tasa de rebote alta con calificaciones bajas indica un fracaso. Una tasa de rebote alta con calificaciones altas indica éxito.

​
Correlaciona tráfico y satisfacción

Las analíticas de Mintlify te permiten ver las puntuaciones de comentarios junto con los datos de tráfico. Usa esto para priorizar:
  • Alto tráfico, baja satisfacción: Páginas populares con una mala experiencia de usuario. Corrige estas primero: afectan a la mayor cantidad de usuarios.
  • Bajo tráfico, alta satisfacción: Contenido que funciona pero que no se encuentra. Verifica si la navegación y los enlaces internos están dirigiendo a los usuarios allí.
  • Alto tráfico, alta satisfacción: Tus páginas con mejor rendimiento. Revísalas en busca de patrones para aplicar en otros lugares.

​
Recopila comentarios cualitativos

Los números te dicen que algo está mal. Los comentarios cualitativos te dicen qué.

​
Calificaciones y comentarios en la página

Habilita los comentarios en tus páginas de documentación para que los lectores puedan indicar cuando algo no funciona. Los campos de comentarios abiertos revelan problemas específicos —pasos poco claros, capturas de pantalla desactualizadas, información faltante— que las calificaciones por sí solas no pueden identificar. Consulta Comentarios para configurar la recopilación de comentarios.

​
Aportaciones de las partes interesadas

Los equipos más cercanos a los usuarios tienen información que las analíticas no pueden revelar:
  • Los equipos de soporte saben qué temas de documentación generan más tickets y dónde los usuarios se atascan constantemente
  • Los equipos de éxito del cliente ven con qué páginas los nuevos usuarios tienen dificultades durante la incorporación
  • Los equipos de ingeniería saben cuándo la documentación describe un comportamiento que ha cambiado
Reuniones periódicas con estos equipos —incluso mensuales o trimestrales— revelan brechas que los datos de usuarios por sí solos no detectan.

​
Investigación de usuarios

Las conversaciones directas con los usuarios proporcionan una profundidad que las analíticas y las calificaciones no pueden ofrecer. Pide a los usuarios que realicen una tarea específica usando solo la documentación y que narren su proceso de pensamiento. Sus instintos sobre dónde buscar y dónde se confunden revelan problemas estructurales y de terminología que resultan invisibles para las personas que conocen bien el producto. Consulta Comprende a tu audiencia para más información sobre métodos de investigación.

​
Alinea la documentación con los objetivos de negocio

La calidad de la documentación también se refleja en las métricas de negocio. Conectar el trabajo de documentación con los resultados de negocio fortalece el caso para invertir en documentación.

​
Eficiencia del soporte

Rastrea si las mejoras en la documentación reducen el volumen de tickets de soporte para temas específicos. Cuando una guía de instrucciones mejora significativamente, el volumen de tickets para ese tema debería disminuir. Esto hace que el ROI de la documentación sea visible y medible.

​
Incorporación y activación de usuarios

La documentación es a menudo el camino crítico para que los nuevos usuarios activen el producto. Si las analíticas de incorporación muestran que los usuarios abandonan en un paso específico, la documentación de ese paso es una causa probable.

​
Señales de retención

Una documentación que es constantemente inexacta o incompleta erosiona la confianza en el producto, no solo en la documentación. Los usuarios que encuentran documentación incorrecta pierden confianza en la fiabilidad del producto en sí. La calidad de la documentación es parte de la calidad del producto.

​
Prioriza y actúa

Medir solo es útil si impulsa la acción. Algunos enfoques para decidir qué corregir primero:
  • Corrige primero los problemas de alto tráfico. La misma hora de trabajo de mejora afecta a muchos más usuarios en una página con 5,000 vistas mensuales que en una página con 50.
  • Responde a comentarios específicos. Cuando los usuarios dejan comentarios específicos —“este ejemplo no funciona” o “a este paso le falta información”— son señales de alta precisión que requieren poca investigación para actuar.
  • Enfócate en los recorridos clave del usuario. Identifica las tres a cinco tareas más críticas para el éxito de tu producto y asegúrate de que la documentación que respalda esas tareas sea excelente antes de preocuparte por el resto.
Usa flujos de trabajo para automatizar mejoras recurrentes, como abrir un pull request con correcciones sugeridas para páginas marcadas por puntuaciones de comentarios bajas.

​
Preguntas frecuentes

Comienza con la intersección de alto tráfico y bajas puntuaciones de satisfacción. Estas páginas afectan a la mayor cantidad de usuarios y tienen la señal más clara de que algo no funciona. Si aún no tienes puntuaciones de comentarios, comienza con tu equipo de soporte: ellos saben qué páginas generan más confusión sin necesidad de ninguna configuración de analíticas.
No existe un punto de referencia universal. Rastrea tu propia línea base a lo largo del tiempo y considera la mejora constante como el objetivo. Una página calificada positivamente por el 80% de los usuarios es un objetivo razonable para contenido importante. Lo que importa más que la puntuación absoluta es la dirección de la tendencia y cómo se comparan tus páginas más importantes con tu promedio.
Mensualmente para páginas de alto tráfico y tendencias generales de satisfacción. Trimestralmente para una auditoría de contenido más profunda que analice patrones de navegación, consultas de búsqueda sin resultados y páginas que no se han actualizado recientemente. La revisión en tiempo real no es necesaria a menos que acabes de lanzar un cambio importante.
Analiza la página de forma analítica. Un tiempo alto en la página combinado con calificaciones negativas suele significar que los usuarios tienen dificultades para seguir las instrucciones. Un tiempo bajo combinado con calificaciones negativas suele significar que los usuarios no encontraron lo que buscaban. Cruza los datos con los temas de tickets de soporte de esa página para obtener una señal más específica. Cuando no puedes diagnosticar el problema a partir de los datos, una breve sesión de entrevista con usuarios lo resolverá rápidamente.

Resumen de analíticas

Visualiza analíticas y rastrea el rendimiento de la documentación.

Comentarios

Recopila y analiza los comentarios de los usuarios sobre tu documentación.

Comprende a tu audiencia

Investiga y define la audiencia de tu documentación.

SEO

Optimiza tu documentación para los motores de búsqueda.