Comentarios

Supervisa la satisfacción de los usuarios con tu documentación

Para recopilar y ver comentarios, primero debes habilitar la función de comentarios desde la página de Add-ons en tu panel.

La pestaña de comentarios muestra los votos cuantitativos de pulgar arriba y pulgar abajo que han recibido tus docs y cualquier comentario cualitativo que hayan proporcionado los usuarios. Usa esta información para evaluar la calidad de tus docs y realizar mejoras.

Accede a la pestaña de comentarios desde la página de Analytics en tu panel.

​

Tipos de comentarios

Los comentarios contextuales y en fragmentos de código están en beta. Para habilitarlos en tu sitio de documentación, contacta a nuestro equipo de ventas.

La pestaña de comentarios muestra información según los complementos de comentarios que habilites.

Habilita tus tipos de comentarios preferidos:

• Solo valoración con pulgares: Votación simple de pulgar arriba/abajo para medir la satisfacción general con las páginas.
• Solo comentarios sobre fragmentos de código: Comentarios específicamente sobre fragmentos de código.
• Valoración con pulgares y comentarios contextuales: Votación de página más comentarios detallados y motivos de las valoraciones.
• Valoración con pulgares y comentarios sobre fragmentos de código: Votación de página más comentarios sobre ejemplos de código.
• Valoración con pulgares, comentarios contextuales y comentarios sobre fragmentos de código: Sistema de comentarios completo con votación de página, comentarios detallados y comentarios sobre fragmentos de código.

​

Gestión de comentarios

Para comentarios contextuales y sobre fragmentos de código, puedes establecer el estado de un comentario y añadir notas internas para hacer seguimiento de tu trabajo al resolver el feedback de los usuarios.

​

Cambiar el estado de los comentarios

Selecciona el estado junto a un comentario para marcarlo como Pendiente, En progreso, Resuelto o Descartado.

Mejores prácticas para definir estados de comentarios:

• Pendiente: El comentario está a la espera de revisión.
• En progreso: El comentario ha sido validado y se está trabajando en él.
• Resuelto: El comentario se ha resuelto.
• Descartado: El comentario se descarta por no ser accionable, por irrelevante o por inexacto.

​

Filtrar por estado

Utiliza el filtro de estado para controlar qué comentarios se muestran. Desmarca un estado para ocultar todos los comentarios con ese estado. De forma predeterminada, se muestran todos los comentarios.

​

Agregar notas internas

Haz clic en un comentario para agregar una nota interna. Estas notas solo son visibles para quienes tienen acceso a tu panel.

Usa las notas para añadir información para la colaboración, enlazar tickets relevantes de soporte o de ingeniería, o recordar cualquier otra información útil.

​

Uso de los datos de comentarios

Revisa tus datos de comentarios para:

• Identificar contenido eficaz: Las páginas con más comentarios positivos muestran qué funciona bien en tu documentación.
  • Priorizar mejoras: Las páginas con más comentarios negativos indican qué contenido podría requerir atención.
  • Tomar acción: Realiza actualizaciones en la documentación basadas en comentarios directos de los usuarios.